Вывод
В этой главе мы рассмотрели два фундаментальных понятия REST-api: ресурсы и идентификаторы. Ресурсы представляют собой сущности, которые могут быть представлены в виде данных, а идентификаторы – это уникальные ключи, позволяют нам обращаться к ресурсам. Идентификаторы чисел, строк или комбинации обоих, они используются для построения URL-адресов, клиентам следующей рассмотрим, как использовать REST-api.
2.2. HTTP-методы и статусы
Когда мы начинаем строить REST-api, нам необходимо понимать основные строительные блоки, которые составляют эту технологию. Одним из ключевых элементов являются HTTP-методы и статусы. В этой главе рассмотрим, что такое статусы, как они используются в REST-api.
HTTP-методы
HTTP-методы – это способ, которым клиент (например, веб-браузер или мобильное приложение) взаимодействует с сервером. Каждый метод имеет свое конкретное назначение и используется для выполнения определенных действий. Существует несколько основных HTTP-методов:
GET: используется для получения ресурса с сервера. Например, когда вы открываете веб-страницу, ваш браузер отправляет GET-запрос на сервер, чтобы получить содержимое страницы.
POST: используется для создания нового ресурса на сервере. Например, когда вы регистрируетесь сайте, ваш браузер отправляет POST-запрос сервер, чтобы создать новый аккаунт.
PUT: используется для обновления существующего ресурса на сервере. Например, когда вы редактируете профиль сайте, ваш браузер отправляет PUT-запрос сервер, чтобы обновить информацию.
DELETE: используется для удаления ресурса с сервера. Например, когда вы удаляете пост в социальной сети, ваш браузер отправляет DELETE-запрос на сервер, чтобы удалить пост.
HTTP-статусы
HTTP-статусы – это способ, которым сервер сообщает клиенту о результате запроса. Статусы представляют собой трехзначные коды, которые указывают на успех или неудачу Существует несколько основных категорий HTTP-статусов:
1xx: информационные статусы, которые указывают на то, что запрос принят и обрабатывается.
2xx: успешные статусы, которые указывают на то, что запрос выполнен успешно. Например, статус 200 OK указывает успешно и ресурс возвращен.
3xx: перенаправляющие статусы, которые указывают на то, что ресурс перемещен или доступен по другому адресу.
4xx: клиентские ошибки, которые указывают на то, что запрос неверен или не может быть выполнен. Например, статус 404 Not Found указывает ресурс найден.