REST — это архитектурный стиль, а не спецификация. На практике API работает по принципу RESTful: элементы системы имеют URL-адреса, HTTP-метод указывает, что с ними нужно сделать, код состояния указывает, что произошло, и сервер не хранит сессию для каждого клиента между запросами. Все необходимое для обработки запроса поступает вместе с ним.
Коллекция находится по пути — /characters — а элемент внутри неё — по адресу /characters/1. GET-запросы считывают данные, POST-запросы создают, PUT-запросы заменяют, PATCH-запросы изменяют, DELETE-запросы удаляют. Фильтрация, сортировка и пагинация зависят от строки запроса. Представление данных согласовывается с Accept и Content-Type, а не закладывается в URL. Основной результат — статус ответа: клиент, считывающий только тело запроса, отбрасывает половину ответа.
REST подразумевает использование JSON поверх HTTP. Это не так — REST ничего не говорит о JSON, и многие API, использующие JSON поверх HTTP, вообще не являются RESTful (единственная конечная точка /api , принимающая имя действия в теле запроса, — это RPC в обличии REST). Отличительной особенностью является то, что ресурсы являются адресуемыми, а метод содержит глагол.
Каталог содержит 39 REST API с 338 конечными точками. Любой из них подойдёт для освоения основ; Protocol Lab — это платформа, специально разработанная для тех частей HTTP, которые большинство тестовых API пропускают.
Все термины · Приёмы тестирования · Все 39 mock REST API
Последнее обновление