Понимание интерфейсов программирования веб-приложений (API) важно для многих профессий в технологической отрасли. Backend-разработчики создают API, frontend-разработчики используют их для создания приложений, а тестировщики проверяют, работают ли они должным образом. Есть много аспектов и соображений, связанных с API, и поначалу все это может сбивать с толку. В этой статье я покажу вам, что вы должны знать, чтобы эффективно работать с веб-API.

Что такое веб-API

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

HTTP

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

URL-адрес

Каждый запрос, который мы отправляем с помощью HTTP, запрашивает определенный ресурс, идентифицируемый с помощью универсального указателя ресурсов (URL). Пример URL-адреса: https://how-to.dev/what-is-an-api, где у нас есть:

  • https-протокол, в данном случае безопасный HTTP,
  • how-to.dev-домен, указывающий на сервер, отвечающий за ресурс,
  • what-is-an-api-ресурс на этом сервере.

Метод запроса

Каждый HTTP-запрос содержит метод, который объясняет, что клиент хочет сделать с рассматриваемым ресурсом. В протоколе определено 9 методов, одни из которых широко используются, а другие малоизвестны.

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

Другим распространенным методом является POST. Он отправляет данные на сервер и ожидает ответа на то, что было отправлено. Его не следует кэшировать, потому что он часто изменяет данные на сервере. Поскольку он обеспечивает двустороннюю связь, он очень часто используется для веб-API. Так…