Что такое функции API? (Типы, компоненты и 3 примера)

21 октября 2021 г.

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

Что такое функции API?

Интерфейс прикладного программирования (API) предназначен для того, чтобы позволить различным системам, приложениям и устройствам обмениваться информацией друг с другом. API работают путем преобразования ввода пользователя в данные, что помогает системе отправлять правильный ответ. Например, если вы оплачиваете счет за телефон через Интернет для компании, API уведомляет веб-сайт или систему приложения о том, что вы нажали «оплатить», предлагая системе запросить вашу платежную информацию.

Типы API

Вот несколько способов, которыми разработчики часто программируют свои API:

API-интерфейсы SOAP

API-интерфейсы простого протокола доступа к объектам (SOAP) — это тип инструментов веб-разработки, которые могут читать как люди, так и машины. Чтобы правильно использовать SOAP API, разработчикам часто приходится следовать четким правилам написания запросов и ответов. Это может гарантировать, что контент, который они пишут, легко интерпретируется машинами и анализируется пользователями.

REST API

Передача репрезентативного состояния (REST) ​​— это еще один тип API. Разработчики обычно стремятся проектировать REST API таким образом, чтобы их было легко использовать и понимать. Они достигают этого, написав эффективную конечную точку продукта, которая является концом канала связи, который передает конкретную идею API. Конечные точки часто встречаются в конце URL-адреса. Разработчики могут использовать простую конечную точку, такую ​​как «/products», вместо менее понятной, например «/pro_429», чтобы пользователи могли ее легко понять.

Частные API

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

Открытые API

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

Компоненты функций API

Вот компоненты, которые разработчики используют для разработки API:

Заголовок

Заголовки служат дополнительным источником информации для каждого вашего запроса API. Они представляют собой метаданные каждого запроса и ответа. Заголовок часто является первым местом, на которое разработчики обращают внимание при решении проблем с API.

Конечная точка

Конечная точка — это часть URL-адреса, которая взаимодействует с API. API работают через запросы и ответы с конечными точками. Когда API запрашивает данные у приложения или сервера, конечная точка отправляет ответ. Это помогает API получать необходимые ресурсы с сервера для выполнения задачи. Конечные точки также могут помочь пользователям легко понять назначение URL-адреса. Например, страница корзины покупок на веб-сайте может использовать конечную точку «/cart».

Метод

Вот некоторые наиболее распространенные методы, которые разработчики используют для выполнения определенного запроса:

• Удалить: разработчик может использовать этот запрос, чтобы указать серверу удалить ресурс. Например, вы можете использовать этот запрос для удаления сообщения в блоге.

• Put: разработчики используют «put», чтобы запросить обновление существующего ресурса или создать новый. Например, вы можете использовать эту функцию для обновления цен на все рубашки в интернет-магазине веб-сайта.

• Сообщение: в то время как «публикация» создает и обновляет существующие ресурсы, отправляя данные на сервер, такие как запрос «поместить», запросы «публикации» также накапливаются, если вы используете их несколько раз. Например, если вы сделаете два запроса на «публикацию», чтобы добавить нового пользователя в свой информационный бюллетень, имя пользователя может появиться в списке пользователей дважды.

• Get: запрашивает информацию с сервера. Например, вы можете использовать запрос «получить», чтобы получить список всех людей, подписавшихся на информационный бюллетень.

Данные

Разработчики также называют данные телом запроса, который они либо отправляют на сервер, либо сервер возвращает им. Иногда разработчику необходимо ввести определенную информацию, прежде чем он сможет внести изменения или добавить данные. Например, если вы редактируете определенный продукт на веб-сайте доставки, сервер может запросить у вас идентификатор продукта, прежде чем он позволит вам изменить продукт.

3 примера функций API

Вот три примера того, как функции API оптимизируют взаимодействие с пользователем:

1. Поиск отелей

Вот пример того, как функции API могут улучшить поиск отелей:

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

2. Поиск нового ресторана

Ниже приведен пример того, как функции API могут оптимизировать поиск ресторана пользователем:

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

3. Сбор и обмен данными

Вот пример того, как функции API могут улучшить попытки пользователя собирать данные и делиться ими:

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