Конечная точка — это комбинация HTTP-метода и URL-адреса, на которую отвечает сервер: GET /orders и POST /orders — это две конечные точки одного и того же ресурса. Документация, правила доступа, ограничения скорости и тесты обычно организуются для каждой конечной точки, что делает её единицей измерения при определении размера API.
Путь указывает имя ресурса, параметры пути выбирают один экземпляр ( /orders/{id} ), строка запроса сужает или формирует результат, а метод указывает, что с ним делать. Сервер направляет каждый входящий запрос обработчику, зарегистрированному для данного метода и шаблона пути, и на запрос, соответствующий пути, но не методу, отвечает код 405, а не 404.
Конечная точка — это URL-адрес. Тот же URL-адрес, но с другим методом, представляет собой другую конечную точку с другими правилами — запрос GET /orders/7 может быть публичным, в то время как для DELETE /orders/7 требуется токен администратора. Тестирование одного метода и предположение о том, что остальные ведут себя одинаково, — вот как выявляются уязвимости в системе авторизации, которые не проходят проверку.
На каждой странице документации указаны конечные точки с методом, путем и кодами состояния, которые каждая из них может возвращать; например, путь DELETE /menu в API Pizza существует для запроса GET, но на каждый запрос DELETE отвечает кодом 405.
Все термины · Приёмы тестирования · Все 39 mock REST API
Последнее обновление