Главная / Словарь / Что такое API

Что такое API

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

Зачем API, если можно выгрузить в таблицу?

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

Что нужно, чтобы подключиться к API?

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

Почему интеграция ломается?

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