Стать клиентом

API: Application Programming Interface

API: Application Programming Interface
Андрей Гусаров, директор GUSAROV·Обновлено 06.11.2026·5 мин

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

Кратко

  • API работает как договор: одна программа предлагает функции, другая обращается к ним по описанным правилам.
  • Веб-интерфейс предназначен человеку (кнопки, поля), API предназначен программам (запросы и ответы).
  • Пример для сайта: карта Google Maps на странице подключается через API, а отчёты Google Analytics можно получать в свою систему программно.
  • Что можно делать через API, определяет документация поставщика, поэтому перед интеграцией читайте её.

Кому и зачем это знать

С запросом «API» приходят люди с разными задачами. Найдите свою ситуацию.

Владелец бизнесаСитуация: Подрядчик предлагает «подключить по API» CRM и сайт, и нужно понять, о чём речь.Зачем: Интеграция по API экономит ручной перенос данных, но требует доступа, времени разработчика и поддержки.Что сделать: Спросите, какие данные и в какую сторону будут передаваться, кто хранит доступы и что будет, если сервис изменит правила. Попросите ссылку на документацию поставщика. Если интеграция нужна для одной редкой операции, сравните стоимость с ручным вариантом.
Маркетолог, аналитикСитуация: Нужно собирать данные из нескольких систем в один отчёт.Зачем: Если у системы есть такой интерфейс для отчётов, данные можно получать автоматически, а не выгружать вручную.Что сделать: Проверьте в документации системы, есть ли интерфейс для отчётов и какие показатели он отдаёт. Например, Google Analytics Data API по документации позволяет программно получать отчёты и строить собственные панели. Сверьте цифры с интерфейсом системы на одном периоде перед запуском.
РазработчикСитуация: Нужно подключить внешний сервис к сайту.Зачем: Ошибки в интеграции видны пользователям: карта не загрузилась, форма не отправилась.Что сделать: Читайте документацию поставщика, храните доступы не в коде страницы, которую видит любой посетитель, обрабатывайте ошибки ответа и тестируйте на тестовых данных. Опишите в проекте, что делать, если сервис недоступен.
НовичокСитуация: Встретили слово API в задании или переписке.Зачем: Термин встречается в документации, вакансиях и в обсуждении интеграций.Что сделать: Запомните образ розетки: это стандартное «гнездо», в которое вставляют готовую функцию, не разбираясь в её устройстве.

Как работает API: договор между программами

По определению MDN, API — это простой договор между приложением, которое его предлагает, и другими программами или оборудованием. Он описывает функции и правила обращения, а не устройство программы внутри.

  • Есть поставщик. Программа или сервис, который предлагает функции: карту, отчёты, оплату.
  • Есть документация. В ней описано, к чему можно обратиться и как.
  • Есть потребитель. Другая программа, например ваш сайт, которая обращается по описанным правилам.

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

Виды API: браузерные и сторонние

MDN делит API в браузерной разработке на две группы.

ВидЧто этоПример по MDN
Браузерныевстроены в браузер и дают доступ к данным браузера и компьютераWeb Audio API
Сторонниене встроены в браузер, код и данные получают из сетиGoogle Maps: интерактивная карта на сайте

Название «веб-API» MDN относит к набору возможностей, который может включать методы, свойства, события и URL-адреса.

API в маркетинге: примеры для сайта и аналитики

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

  • Карта на сайте. Через Google Maps на странице отображается интерактивная карта, например, с офисом компании (пример MDN).
  • Отчёты аналитики. По документации Google Analytics Data API позволяет программно получать данные отчётов, строить собственные панели и подключать данные к другим бизнес-приложениям.
  • Доступ. В примере документации запрос подтверждается токеном доступа, а в заголовке указывается проект Google Cloud.

Что проверить перед подключением по API

ВопросЗачем
Есть ли у сервиса программный интерфейс и что он умеетнабор функций определяет поставщик
Где документацияпо ней разработчик строит интеграцию
Как подтверждается доступот этого зависит безопасность данных
Что будет при недоступности сервисачтобы сайт не ломался для посетителей
Совпадают ли данные с интерфейсом системызащита от ошибок в отчётах

Типичные ошибки

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

Частые вопросы

Что такое API простыми словами?

Договор между программами: одна предлагает функции и описывает правила обращения, другая обращается к ним. Человеку удобна кнопка, программе удобен такой договор.

Как расшифровывается API?

Application Programming Interface, по-русски интерфейс прикладного программирования.

Приведите пример API для сайта.

Google Maps API: по MDN, он позволяет показать на сайте интерактивную карту, например, с вашим офисом. Другой пример: Google Analytics Data API для получения отчётов Analytics в своей системе.

Чем он отличается от веб-интерфейса?

Веб-интерфейс даёт человеку кнопки и поля в браузере, а программам даёт функции интерфейс программирования. Разница в том, кто пользуется.

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

По MDN, это набор возможностей для разработчика, который может включать методы, свойства, события и URL-адреса. Веб-API взаимодействуют с компонентами браузера, другим программным или аппаратным обеспечением и сторонними сервисами.

Что нужно для подключения?

Документация поставщика и доступ к его сервису. Например, запрос к Google Analytics Data API в документации подтверждается токеном доступа проекта Google Cloud. Для других сервисов смотрите их документацию.

Зачем это маркетологу?

Чтобы автоматически получать данные из систем в один отчёт и не переносить их вручную. Какие данные доступны, определяет документация конкретной системы.

Связанные термины

  • Веб-интерфейс: интерфейс для человека в браузере, тогда как API предназначен для программ
  • Script: программа, выполняющая действия; скрипт может обращаться к API, но это не одно и то же
  • Протокол: правила обмена сообщениями между устройствами, а API описывает обращение к функциям конкретной программы
  • CMS: система управления сайтом; у неё может быть собственный API, но CMS и API не синонимы
  • Google Analytics: система аналитики, отчёты которой доступны через API
Получить кейсы Написать в Telegram
При нахождении на сайте Вы соглашаетесь с политикой обработки персональных данных.
Всё понятно!