Ответ
Типичный HTTP-запрос в REST API состоит из следующих обязательных и опциональных компонентов:
-
HTTP-метод (Verb) — определяет операцию над ресурсом.
- GET: получение данных.
- POST: создание ресурса.
- PUT/PATCH: полное/частичное обновление.
- DELETE: удаление ресурса.
-
URL (Endpoint/URI) — адрес целевого ресурса.
- Пример:
https://api.example.com/v1/users/456
- Пример:
-
Заголовки (Headers) — метаданные запроса.
Content-Type: формат тела запроса (например,application/json).Authorization: данные для аутентификации (например,Bearer <token>).Accept: ожидаемый формат ответа.
-
Тело запроса (Body) — данные, отправляемые на сервер (для POST, PUT, PATCH).
{ "name": "Alice", "email": "alice@example.com" } -
Параметры строки запроса (Query Parameters) — опциональные данные, добавляемые в URL после
?.- Пример:
GET /api/users?role=admin&page=2
- Пример:
Полный пример запроса на создание пользователя:
POST /api/v1/users HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9
{
"username": "johndoe",
"active": true
}
Почему это важно для тестирования: Каждый компонент (метод, заголовки, тело, параметры) должен быть проверен на валидность, безопасность и соответствие спецификации API.