API (аpplication programming interface)

Одобренно экспертом
Ахмад Боков
Эксперт статьи
Ахмад Боков
Основатель чат-бот агентства BotCreators
Автор статьи
Джулия Фатхутдинова

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

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

Зачем нужен API

Приложение прогноза погоды на смартфоне запрашивает информацию у метеорологического сервиса через API

Application Programming Interface (API) переводится как программный интерфейс приложений. Это своего рода инструкция-алгоритм, которая позволяет программам общаться между собой и обмениваться данными.

 

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

Где используется API

API позволяет интегрировать в программу функции, которые уже реализованы в другом приложении. Например, добавить на свой сайт «Яндекс.Карты» или подключить сервис email-рассылок к собственной СRМ-системе. 

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

Примеры API

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

Карта на сайте интернет-магазина

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

Агрегатор отелей

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

Платежная форма ЮKаssа

Авторизация через соцсети. Формы для быстрой регистрации и авторизации через социальные сети встречаются на многих ресурсах. Пользователю просто и удобно создать учетную запись на сайте в два клика, а не заполнять каждый раз однотипную форму.

Регистрация через соцсети

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

Диалоговое окно в Windows

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

Какие преимущества дает API

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

  • Ускорить выпуск новых приложений. Для стандартных задач выгодно использовать готовые решения,  а не придумывать все с нуля.
  • Защитить разработку. API позволяет скрыть отдельные функции программы и сделать их доступными только через интерфейс.
  • Упростить и стандартизировать способ взаимодействия между приложениями, расширить возможности интеграции между сервисами.
  • Сократить бюджет на разработку за счет использования готовых решений.
  • Получить дополнительную прибыль. Создатели сложных программных продуктов через API предоставляют платный доступ к функциям другим разработчикам.
  • Автоматизировать взаимодействие между программами. Больше не нужно вручную перекладывать данные из банка в учетную систему. У банка есть API, и учетная система сходит и сама заберет нужные данные без участия человека

Как работает Application Programming Interface

Принцип работы Application Programming Interface очень прост. Программа-клиент формирует запрос к API — выполнить операцию. Интерфейс получает данные и перенаправляет запрос программе-поставщику, которая реализует функцию. А затем возвращает результат клиенту. Если операцию не удалось выполнить или запрос некорректный, API формирует сообщение об ошибке.

Как работает API

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

Программный интерфейс по сути — это соглашение или контракт о том, как происходит взаимодействие между приложениями. Чтобы я сделал «А», ты должен сделать «Б».

API представляет собой список правил, который включает описание:

  • методов, то есть что API может сделать;
  • входящих данных к каждому методу;
  • исходящих данных, ответов.

На языке людей, это могло бы выглядеть так:

  • мы можем приготовить для вас пиццу;
  • для этого сделайте запрос по типу: «Приготовьте пиццу Пепперони на тонком тесте диаметром 30 см»;
  • в результате вы получите готовую пиццу или ответ об ошибке: «Мы не можем приготовить заказ, потому что Пепперони закончилась».

На программном уровне современные Web API, как правило, обмениваются между собой особыми текстовыми файлами формата JSON. API пиццерии в ответ на заказ пиццы ответит вам или другой программе вот таким документом:
{

  "status": "Готов",

  "waiting_time": 20,

  "type": "Перерони, 30 см"

}

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

Ахмад Боков

Ахмад Боков

Основатель чат-бот агентства BotcCreators
Методы API

Пример методов, входящих данных и ответов в API Unisender

Существуют API с локальным и удаленным доступом. 

API с удаленным доступом работают через интернет. В этом случае говорят о взаимодействии клиента, программы выполняющей запрос, и сервера, программы посылающей ответ. Чтобы вызвать метод, клиент формирует URL и «переходит» по ссылке, то есть отправляет запрос серверу.

Вызов метода

Так выглядит вызов метода для создания шаблона email-письма в API Unisender

При локальном доступе необходимо установить приложение, которое реализует функции API. Код поставщика при этом может быть скрыт или защищен. Вам не нужно вникать и разбираться, как он устроен.

Как подключить API

У каждой программы или приложения есть собственная подробная инструкция. Рассмотрим общие правила работы с API на примере веб-сервисов. 

  • Компания-разработчик пишет программу. Например, сервис Unisender, который позволяет создавать и отправлять email-рассылки.
  • Затем она составляет API — инструкцию для других разработчиков, как они могут использовать программу в своем приложении. Например, уведомлять клиентов о статусе заказа или делать рассылки по базе клиентов.
  • Вы получаете доступ к API. Он может быть частным или публичным. В первом случае необходимо создать учетную запись в сервисе поставщика и получить API-ключ. Это аналог логина и пароля, который помогает системе опознать клиента. Для доступа к публичным авторизация не нужна.
  • Устанавливаете клиент API. Чаще всего для этого необходимо вставить код поставщика API в свое приложение: в систему сборки или в код веб-страницы.
  • Если поставщик не предоставляет готовый клиент API, то разработчикам приложения нужно самостоятельно написать код, который взаимодействует с API. Как это сделать, разработчики прописывают в документации.
  • Проводите тестовый запуск, убеждаетесь, что API отдает те данные, которые вы ждали.
  • Теперь ваша программа может обращаться к другому приложению через API и использовать его функции.

 

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

Главные мысли

API это

 

Вы нашли ответ?

23
2