Что такое эндпоинт (endpoint) в контексте API?

«Что такое эндпоинт (endpoint) в контексте API?» — вопрос из категории API тестирование, который задают на 10% собеседований QA Тестировщик. Ниже — развёрнутый ответ с разбором ключевых моментов.

Ответ

Эндпоинт (endpoint) — это уникальный URL, по которому клиентское приложение взаимодействует с серверным API для выполнения конкретной операции над ресурсом.

Структура эндпоинта:

  • Метод HTTP: Определяет действие (GET, POST, PUT, PATCH, DELETE).
  • Путь (Path): Указывает на ресурс или коллекцию (например, /api/users).
  • Параметры: Могут быть в пути (/users/{id}), строке запроса (?page=2) или теле запроса (для POST/PUT).

Примеры:

GET    /api/v1/products          # Получить список товаров
POST   /api/v1/products          # Создать новый товар
GET    /api/v1/products/42       # Получить товар с ID=42
PUT    /api/v1/products/42       # Полностью обновить товар 42
DELETE /api/v1/products/42       # Удалить товар 42

Что тестируют в эндпоинтах:

  1. Корректность HTTP-метода.
  2. Валидацию входных данных (параметры, тело).
  3. Ожидаемые статус-коды (200, 201, 400, 404, 500).
  4. Структуру и данные в ответе (JSON Schema).
  5. Авторизацию и права доступа.