Параметры запроса

Параметры запроса — это часть URL-адреса после вопросительного знака — ?status=open&sort=-created&limit=20. Они не идентифицируют другой ресурс; они изменяют запрос для того ресурса, путь к которому указан, поэтому они обычно используются для фильтрации, сортировки, пагинации, поисковых запросов и параметров вывода.

Как это работает

Пары символов разделяются символом &, и каждое значение кодируется в процентах, поэтому пробел становится %20, а амперсанд внутри значения — %26. Повторяющиеся ключи (?tag=a&tag=b) допустимы, но не имеют стандартного значения — фреймворки сохраняют первый, последний или все из них. Поскольку они являются частью URL-адреса, они попадают в журналы, историю браузера и кэш.

Заблуждение

Эти неизвестные параметры запроса безвредны. Многие API молча игнорируют неправильно написанный фильтр — ?stauts=open — и возвращают все, что выглядит как успех и является ошибкой в клиенте. Строгий API вместо этого отвечает кодом 400; тест должен проверить, к какому типу относится ваш API.

Попробуйте здесь.

API поиска и фасетной навигации отклоняет неизвестные параметры запроса GET /search/v1/items , как и список персонажей сериала «Друзья» версии 1. API фильмов объединяет фильтрацию, сортировку и пагинацию при запросе GET /movies/v1/movies.

Источники

Другие термины

REST API — API, моделирующий систему как адресуемые ресурсы, которыми можно управлять с помощью стандартных методов HTTP.
конечная точка API — Один URL плюс один HTTP-метод — наименьшая единица API, которую может вызвать клиент.
Параметры пути — Переменный сегмент пути URL, например, 42 в /orders/42 , который идентифицирует один конкретный ресурс.
HTTP-заголовки — Метаданные типа «имя-значение» отправляются с каждым запросом и ответом отдельно от тела запроса.
коды состояния HTTP — Трехзначное число в начале каждого HTTP-ответа, которое перед телом сообщает о произошедшем.
согласование содержания — Клиент и сервер согласовывают формат ответа посредством заголовков, а не отдельных URL-адресов.

Читать страницу на английском

Все термины · Приёмы тестирования · Все 39 mock REST API

Последнее обновление 16 октября 2026 г.