Как работает метод REST API? Часть 2
Метод REST API нужен для того, чтобы передавать пользователю сайта или приложения необходимую информацию с сервера. Это помогает упростить взаимодействие между клиентом и сервером.
В 1-ой части статьи мы рассказали вам, что такое REST API и рассмотрели 7 принципов написания кода. В этой части мы более подробно рассмотрим архитектуру и преимущества метода.
Архитектура REST API
REST API работает на протоколе HTTP — это стандартный протокол в интернете для передачи гипертекста. Как и все запросы к REST API, этот запрос содержит две части информации:
- GET — это метод HTTP, который определяет действие, которое клиент хочет произвести над ресурсом. Клиент может выполнить четыре основных HTTP-запроса:
- GET: для извлечения ресурса;
- POST: для создания нового ресурса;
- PUT: для редактирования или обновления существующего ресурса;
- DELETE: для удаления ресурса.
- https://… — это URL-адрес. URL-адрес содержит единый идентификатор ресурса, или URI, который определяет целевой ресурс. В этом случае URL-адрес также называется конечной точкой, потому что это местоположение, где API фактически взаимодействует с клиентом.
Например, запрос видеоданных к YouTube API выглядит следующим образом:
GET: https://www.googleapis.com/youtube/v3/channels?part=contentDetails
А чтобы удалить видео по этому адресу REST API будет использовать метод DELETE.
Такие запросы еще называют идентификаторами CRUD. Это стандартные действия для работы с данными.
- Create (создать);
- Read (прочесть);
- Update (обновить);
- Delete (удалить).
Как использовать REST API?
Документация по веб-приложениям с общедоступными API будет доступна в разделе «разработчики» на их веб-сайтах. Там вы найдете инструкции о том, как получить доступ к API и использовать его совместно с вашим собственным ПО. Если API построен с использованием принципов REST, в документации это будет указано.
Для работы потребуется ключ API. Ключ API — это уникальная строка символов, которую поставщик API предоставляет разработчику, чтобы авторизовать доступ к своему API. Ключи API часто отправляются с клиентскими запросами для идентификации клиента на сервер. Очень важно, чтобы ключи API были в безопасности.
Чтобы протестировать общедоступный API, используйте инструмент, который может структурировать HTTP-запросы, например Postman.
Преимущества REST API
Ниже рассмотрим основные преимущества этого типа REST API:
- REST API — гибкий. Он может обрабатывать множество типов запросов и отправлять данные в разных форматах. Также он помогает системам и приложениям взаимодействовать друг с другом.
- REST API — масштабируемый. Он нужен для взаимодействия между двумя частями ПО, независимо от размера и возможностей. По мере роста веб-приложений REST API сможет быстро обработать растущее количество запросов.
- REST API — простой. У этого метода относительно простые в создании и использовании технологии. Чтобы запросить ресурс через REST API, вам просто нужно указать URL. Из-за удобной архитектуры этот метод легко реализовать даже тем, кто только начинает свой путь в понимании API.
- REST API — финансово доступный. Создание и обслуживание REST API не требуют больших затрат. Поэтому, если вы хотите расширить свои сервисы — используйте этот метод.
REST API против SOAP API
Пока API соответствует этому набору правил, он будет считаться RESTful. Однако эти правила оставляют разработчикам много возможностей для настройки функциональности своего API. Именно эта гибкость отличает REST API от другого распространенного метода SOAP (Simple Object Access Protocol) — простого протокола доступа к объектам.
Основное различие между REST и SOAP заключается в том, что REST — это набор рекомендаций, а SOAP — это протокол. REST позволяет создавать API любыми методами, включая HTTP, URL и JSON, а SOAP для отправки данных использует только XML. REST — это более простая и эффективная альтернатива SOAP, в ней меньше написания кода, а также нет жесткой структуры и логики. Также в SOAP нет кэширования запросов и очень много документации.
Источник: hubspot.com