Про API запросы и статусы. Для начинающих тестировщиков. 2023 IT

API-запросы представляют собой отправку запросов на сервер по определенным эндпоинтам с использованием различных методов HTTP, таких как GET, POST, PUT, DELETE и других. Тестирование API является одной из важных тем для проверки качества работы ПО.

Далее вы узнаете про основы:

Про API запросы
HTTP статусы

Про API запросы и статусы. Для начинающих тестировщиков. 2023 IT

API запросы могут быть разных типов в зависимости от выполняемого действия и используемого метода. Вот некоторые из наиболее распространенных типов API запросов:

1.) GET: Запрос на получение данных из сервера. Он используется для извлечения информации из ресурса без его изменения.

Получение списка всех пользователей:

GET /api/users

Получение информации о конкретном пользователе:

GET /api/users/{id}

2.) POST: Запрос на создание нового ресурса на сервере. Он используется для отправки данных на сервер для создания нового объекта или выполнения какого-либо действия.

Создание нового пользователя:

POST /api/users Content-Type: application/json { "name": "John Doe", "email": "johndoe@example.com", "age": 25 }

Создание нового заказа:

POST /api/orders Content-Type: application/json { "product": "iPhone", "quantity": 2, "customer_id": "12345" }

3.) PUT: Запрос на обновление существующего ресурса на сервере. Он используется для изменения информации или состояния существующего ресурса.

Обновление информации о пользователе:

PUT /api/users/{id} Content-Type: application/json { "name": "Jane Smith", "email": "janesmith@example.com", "age": 30 }

Обновление информации о заказе:

PUT /api/orders/{id} Content-Type: application/json { "product": "Samsung Galaxy", "quantity": 3, "customer_id": "54321" }

4.) DELETE: Запрос на удаление существующего ресурса на сервере. Он используется для удаления ресурса по его идентификатору или другому уникальному идентификатору.

Удаление пользователя:

DELETE /api/users/{id}

Удаление заказа:

DELETE /api/orders/{id}

5.) PATCH: Запрос на частичное обновление существующего ресурса на сервере. Он используется для изменения только некоторых полей или атрибутов ресурса, не затрагивая остальные.

Частичное обновление информации о заказе:

PATCH /api/orders/{id} Content-Type: application/json { "quantity": 5 }

Частичное обновление информации о пользователе:

PATCH /api/users/{id} Content-Type: application/json { "email": "newemail@example.com" }

HTTP статусы являются важной частью коммуникации между клиентом и сервером в API. Они предоставляют информацию о результате выполнения запроса и помогают клиентскому приложению принять соответствующие действия. Вот некоторые распространенные примеры использования HTTP статусов в API:

200 OK: Запрос успешно выполнен. В ответе содержится запрашиваемая информация.
201 Created: Запрос успешно выполнен, и в результате был создан новый ресурс.
204 No Content: Запрос успешно выполнен, но в ответе нет содержимого.
400 Bad Request: Запрос содержит некорректные данные или не может быть обработан сервером.
401 Unauthorized: Требуется аутентификация для доступа к ресурсу.
403 Forbidden: У клиента нет разрешения на доступ к ресурсу.
404 Not Found: Запрашиваемый ресурс не найден на сервере.
500 Internal Server Error: Произошла внутренняя ошибка сервера при обработке запроса.