Что такое API

Простыми словами

API (Application Programming Interface) — набор правил, по которым программы обмениваются данными. Одна система выставляет «окно обслуживания» и описывает, какие запросы принимает: «дай список товаров», «создай заказ», «проверь статус платежа».

Пользователь API обычно не видит. Когда вы платите картой на сайте, сайт отправляет запрос в API банка, а банк отвечает «оплачено» или «отказано». Так же работают курсы валют в приложении, карта 2GIS на странице контактов и ответы нейросети в чате.

Как это работает

Запрос состоит из адреса, действия и данных. Например, сайт обращается по адресу сервиса доставки, передаёт город и вес посылки и получает в ответ стоимость. Ответ приходит в структурированном виде — чаще всего это формат JSON, который программа разбирает автоматически.

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

Зачем это владельцу бизнеса

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

Если у системы нет API, подключить её к другим можно только выгрузкой файлов, что медленно и ненадёжно. Поэтому при выборе CRM, кассы или учётной программы стоит заранее спросить, есть ли открытое API и платная ли она.

Частые ошибки

• Выбирать систему, не спросив, есть ли у неё API и сколько стоит доступ
• Хранить ключ доступа в коде сайта, который виден всем
• Не обрабатывать ошибки: если API недоступно, сайт просто «ломается»
• Подключаться к неофициальным «ручкам», которые могут исчезнуть без предупреждения
• Не следить за изменениями версий и узнавать о них, когда интеграция уже сломалась