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

API (application programming interface, программный интерфейс приложения) — это способ, которым одна программа обращается к другой. Человек пользуется программой через экран: кнопки, формы, меню. Другая программа пользуется ею через API: отправляет запрос в заранее оговорённом формате и получает ответ. API — это «окно обслуживания» для программ.

Пример из жизни

Представьте ресторан. Гость не идёт на кухню, чтобы приготовить блюдо. Он обращается к официанту, выбирает из меню, и официант передаёт заказ на кухню, а потом приносит блюдо. Меню — это список того, что можно заказать. Официант — это API: он принимает запрос в понятной форме и возвращает результат. Кухня — это внутреннее устройство программы, которое гостю видеть не нужно.

Примеры в бизнесе

• Сайт интернет-магазина спрашивает у учётной системы остатки товара и показывает «в наличии»
• Платёжный сервис сообщает сайту, что заказ оплачен
• Telegram-бот создаёт сделку в CRM, когда клиент оставил заявку
• Учётная система загружает банковскую выписку
• Сервис доставки сообщает статус посылки
• Карта на сайте показывает адреса филиалов через API картографического сервиса

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

Запрос и ответ

Обращение к API состоит из запроса и ответа. Запрос говорит, что нужно: «дай список заказов за сегодня» или «создай клиента с такими данными». Ответ содержит результат: список заказов, номер созданного клиента или сообщение об ошибке. Чаще всего обмен идёт через интернет, а данные передаются в формате JSON — простом текстовом формате, который читают и программы, и люди.

Ключи и доступ

API не открыт всем подряд. Чтобы обратиться к нему, программа предъявляет ключ или токен — аналог пропуска. По ключу система понимает, кто обращается и что ему разрешено. Например, ключ для сайта может только читать остатки, а ключ для бухгалтерии — ещё и создавать документы. Ключи нужно хранить так же бережно, как пароли: кто знает ключ, тот может работать с вашими данными.

Документация

У каждого API есть описание: какие запросы можно отправлять, какие данные передавать, что вернётся в ответ, какие бывают ошибки. Без документации разработчик вынужден угадывать, и интеграция затягивается. Хорошая документация — признак зрелого сервиса. Часто к ней прилагается тестовая среда — «песочница», где можно пробовать запросы, не затрагивая настоящие данные.

Почему это важно при выборе систем

Когда вы выбираете CRM, учётную программу, сервис доставки или онлайн-кассу, спросите: есть ли у неё API и что через него можно сделать. Система с открытым API может обмениваться данными с другими вашими программами, и сотрудникам не придётся переносить данные вручную. Система без API — это остров: всё, что в ней происходит, остаётся внутри, а связи придётся делать через выгрузки файлов или вообще руками.

Чего API не делает сам

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

Итог

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