API
API (Application Programming Interface, программный интерфейс приложения) — это набор правил, по которым одна программа «разговаривает» с другой. Представьте официанта в ресторане: кухня — это сервер с данными, вы — приложение, а официант — API. Вы не ходите на кухню сами: делаете заказ официанту, он передаёт его на кухню и приносит вам готовое блюдо. Примерно так работает API: ваше приложение отправляет запрос, API передаёт его нужной системе, получает ответ и возвращает данные обратно. Именно через API ваш сайт получает курсы валют из банка, карту из Яндекса или данные доставки из СДЭК — без ручного копирования и обновления.
API нужен каждый раз, когда два сервиса должны обмениваться данными автоматически. Интернет-магазин использует API платёжной системы (ЮKassa, Сбербанк), чтобы принять оплату — ваш сайт не хранит данные карт, он просто «спрашивает» платёжный шлюз через API. CRM-система подключается через API к почтовому сервису, чтобы автоматически отправлять письма клиентам. Рекламное агентство использует API Яндекс Директа, чтобы управлять кампаниями программно — менять ставки, выгружать отчёты, останавливать объявления — не заходя в интерфейс вручную. Без API каждая такая интеграция требовала бы разработки с нуля.
Большинство современных API работают по стандарту REST: ваша программа отправляет HTTP-запрос на определённый адрес (его называют endpoint, или эндпоинт) и получает ответ в формате JSON — текстовый файл с данными в виде пар «ключ: значение», который понимают все языки программирования. Чтобы не пускать всех подряд, API требует ключ доступа (API key, или API-ключ) — уникальный токен, который идентифицирует вашу программу. Когда разработчик говорит «нужно получить API-ключ» или «подключиться через API» — он имеет в виду именно этот токен, который поставщик сервиса выдаёт в личном кабинете.
Пример: агентство настраивает рекламу для клиента в Яндекс Директе. Вместо ежедневного ручного входа в кабинет и скачивания отчётов они подключаются к API Директа — скрипт автоматически каждое утро запрашивает статистику (показы, клики, расходы) и записывает её в Google Таблицу клиента. Клиент видит актуальные цифры в реальном времени, агентство экономит несколько часов в неделю. Именно это имеют в виду, когда говорят «настроили интеграцию через API» или «подключили автоматическую выгрузку данных».
