REST API: как и для чего использовать этот метод? Часть 2

Существует множество подходов к созданию API, если вы заинтересованы во внедрении программной интеграции в свой продукт, то вам подойдет метод REST API. 

REST API — это способ взаимодействия сайтов и веб-приложений с сервером. В 1-ой части нашей статьи мы подробно рассмотрели понятие REST API, а также начали рассказывать о шести правилах использования этого метода. 

В этой части мы продолжим делиться этими правилами, рассмотрим отличия REST API от SOAP API, а также расскажем, как и зачем использовать это метод.  

Шесть правил REST API

1. Передача без сохранения состояния

Все вызовы с REST API должны быть без сохранения состояния. Это означает, что взаимодействие должно быть независимым, а каждый запрос и ответ должны предоставлять полнуюинформацию, чтобы завершить взаимодействие. Каждый запрос клиента интерпретируется сервером как новый запрос — сервер ничего не помнит о прошлых запросах.

Передачи без сохранения состояния значительно сокращают объем памяти сервера и повышают шансы на успешный ответ, поскольку серверу не требуется совершать дополнительных действий для извлечения старых данных. По мере того, как ПО растёт и делает больше запросов, разработчикам не нужно беспокоиться об увеличении используемой памяти или перегрузке сервера запросами.

2. Кэширование

Кэширование происходит, когда медиафайлы сохраняются на устройстве клиента при посещении веб-сайта. Когда клиент возвращается на этот сайт, кэшированные данные быстро загружаются из локального хранилища, а не с сервера. 

Кэширование экономит ресурсы сервера и пропускную способность, а также сокращает время загрузки страницы, поэтому большинство крупных веб-сайтов его используют.

REST API создаются с учетом кэширования данных. Когда сервер отправляет свой ответ клиенту, в ответе должно быть указано, можно ли кэшировать предоставленный ресурс и как долго.

3. Код по запросу 

Последний принцип REST — необязательный. При желании API может отправлять компьютерный код клиентам в своем ответе. Это позволяет клиенту запускать код в своем собственном бэкэнде.

Пока API придерживается этого набора правил, он считается RESTful. Однако эти правила позволяют разработчикам настраивать функциональность своего API. Эта гибкость отличает REST API от другого распространенного метода веб-API, простого протокола доступа к объектам (SOAP).

REST API против SOAP API

REST метод обычно сравнивают с SOAP, еще одним способом создания приложений, который работает через HTTP. Основное различие между REST и SOAP заключается в том, что REST — это набор рекомендаций, а SOAP — это протокол. REST позволяет создавать API любым методом, включая HTTP, URL-адреса и JSON. SOAP же использует только XML для отправки данных.

REST считается более простой и эффективной альтернативой SOAP, поскольку для него нужно меньше кода, а структура и логика менее жесткие. 

Кроме того, REST устанавливает барьеры для разработки API, но оставляет множество вариантов на усмотрение разработчика, который создает API.

Зачем использовать REST API?

Фреймворк REST был разработан ученым Роем Филдингом в 2000 году, и сегодня он определяет то, как мы просматриваем, модифицируем и передаем контент в интернете. 

Многие популярные компании используют REST API для своих приложений, включая Facebook, YouTube, Twitter и Google.

Давайте рассмотрим основные преимущества этого типа API:

1. REST API — это гибкий метод. Он может обрабатывать различные типы запросов и отправлять данные в различных форматах.
2. REST API — это масштабируемый метод. Он нужен для связи между любыми двумя частями ПО, независимо от размера или возможностей. По мере того, как веб-приложение растет и добавляет больше ресурсов, его REST API может быстро обрабатывать растущее количество запросов.
3. REST API включает в себя существующие веб-технологии, что делает их относительно простыми в создании и использовании. Чтобы запросить ресурс через REST API, вам просто нужно указать его URL.

Как использовать REST API?

Веб-приложения с общедоступными API будут иметь документацию, доступную в разделе «Разработчики» на веб-сайтах. Именно там вы найдете инструкции о том, как получить доступ к API и использовать его в сочетании с вашим собственным ПО. Если API построен на принципах REST, в документации это будет указано.

Для использования многих API требуется ключ API. Ключ API — это уникальная строка символов, которую поставщик API предоставляет разработчику для авторизации доступа к своему API. 

Ключи API часто отправляются вместе с запросами клиентов для идентификации клиента на сервере. Держите ключи API в конфиденциальном месте.

Чтобы протестировать общедоступный API, используйте инструмент, который может структурировать HTTP-запросы, например Postman. Попробуйте различные HTTP-методы и URL-адреса и посмотрите, что получится.

^{Источник: hubspot.com}