Архитектура REST API состоит из четырех компонентов:
- URL-адрес конечной точки. Приложение с REST API определяет один или несколько URL-адресов конечных точек с доменом, порт, путь, строки запроса;
- Метод HTTP. Есть 5 методов: GET (получение), POST (размещение), PUT (полное обновление), PATCH (частичное обновление), DELETE (удаление);
- Заголовки HTTP. Содержат токены аутентификации или файлы cookie;
- Body. Данные передаются в теле HTTP идентично HTML-представлению.
Первые два компонента разберем на примере следующей строки:
GET https://api.openweathermap.org/data/2.5/weather
GET - это метод для получения, с его помощью мы получим некоторые данные. В самой строке есть HTTPS (протокол), api.openweathermap.org (ресурс или хост), и data/2.5/weather (путь), все вместе это образует
URL - адрес конечной точки. Таким образом, с помощью этой строки мы получим информацию о погоде (температура, давление и др.), данные в ответе уже определены на уровне сервера.
Остальные два компонента определяют, что содержит в себе запрос. Например:
POST /orders
{
"name": "Julia",
"date": "25.03.2023",
"product": "laptop"
}
Часть примера, выделенная фигурными скобками, является телом (body) запроса. С помощью этого запроса мы скажем серверу, что нужно записать (POST) информацию о том, что клиент купил ноутбук 25 марта 2023 года.
Вот еще пару примеров посложнее: