Что такое API простыми словами
API (Application Programming Interface, программный интерфейс приложения) — API это набор правил, по которым одна программа может запросить данные или выполнить действие в другой программе без участия человека.
Удобная аналогия: API похож на окно выдачи в ресторане. Вы делаете заказ по меню (список доступных запросов) и получаете готовое блюдо (данные в понятном формате), на кухню заходить не нужно. Меню описано в документации API.
Пример запроса. Скрипт обращается к API Яндекс Директа: «дай расходы по кампаниям за вчера». Директ отвечает таблицей с кампаниями и суммами. Этот же скрипт отправляет данные в Google Таблицу или дашборд, и маркетолог утром видит расходы, не заходя в кабинет.
Где API используют в маркетинге:
- выгрузка статистики из Директа, VK Рекламы, Метрики в отчёты и дашборды;
- создание сделок в amoCRM и Битрикс24 из внешних источников;
- публикация объявлений и получение откликов на Авито;
- отправка сообщений через Telegram-бота;
- подключение языковых моделей (ChatGPT, YandexGPT, GigaChat) к чат-ботам и ИИ-ассистентам.
Что важно знать заказчику. Доступ к API обычно даётся по токену или ключу. Это как пароль, его нельзя пересылать в открытых чатах. У API есть лимиты: например, не больше определённого числа запросов в минуту, поэтому массовые операции делают порциями. API меняется: сервис выпускает новую версию, старую отключает, и интеграцию нужно обновить.
Чем API отличается от вебхука. По API программа сама спрашивает данные, когда ей нужно. Вебхук работает наоборот: сервис сам присылает сообщение, когда что-то произошло. В хорошей интеграции обычно есть и то, и другое.
Частые ошибки. Хранить ключи API в коде сайта, доступном всем. Не проверять ответы на ошибки, и сбой проходит незаметно. Строить интеграцию на неофициальном API, которое сервис может закрыть в любой момент.
Мы используем API рекламных систем и CRM для сквозной аналитики, автоматических отчётов и ботов.