Что такое API: объясняем владельцу бизнеса за пять минут

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

Как это выглядит на примере

В ToYou Wood после оплаты сайт сам передаёт агрегатору доставки данные заказа, получает номер отправления и печатает этикетку. Человеку остаётся приклеить её и отдать курьеру.

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

Вот эта передача напрямую и есть работа по API. Сайт задал вопрос, сервис ответил, обе стороны поняли друг друга, потому что заранее договорились о формате.

Почему это называется «интерфейс»

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

Второй и называется программным интерфейсом. Он не рисуется, его не видно, и он гораздо строже человеческого: пропущенное поле не прощается, а лишний пробел может означать ошибку.

Правила описываются в документации сервиса. Она отвечает на вопросы, какие запросы принимаются, что обязательно передать и какие ошибки бывают в ответ.

Что даёт бизнесу

Три вещи, каждая измеримая.

Исчезает ручной перенос данных. Один и тот же адрес, сумма или артикул больше не переписываются между окнами, а значит, не появляются опечатки.

Информация становится свежей. Остаток на сайте берётся из системы учёта в момент запроса, а не из выгрузки недельной давности.

Действия происходят без человека и в любое время. Заказ, оформленный в час ночи, оплачивается, создаёт отправление и получает этикетку без участия сотрудника.

Почему интеграция всё равно стоит денег

Наличие API часто понимают как «всё уже сделано, осталось нажать». На деле готов только канал связи.

Работа начинается дальше. Ваши поля надо сопоставить с чужими: у вас «телефон», у них «phone» в определённом формате, у вас категория «шкаф», у них номер категории с обязательными параметрами.

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

И наконец, каждый запрос и ответ пишутся в журнал. Иначе на вопрос «почему заказ не ушёл в доставку» отвечать нечем.

Два слова, которые вам скажут

При разговоре о стыковке всплывают два выражения, и оба стоит понимать.

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

Лимит запросов — ограничение, сколько обращений в минуту сервис готов принять. Превышение приводит к отказу, поэтому массовые операции ставятся в очередь и выполняются порциями, а не разом.

Когда API не нужен

Если у вас три заказа в день, а сотрудник и так сидит в двух вкладках, интеграция не окупится. Ручной перенос данных при таком объёме стоит дешевле разработки.

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

Если процесс на вашей стороне ещё не устоялся и правила меняются каждую неделю, стыковать рано. Сначала договорённости, потом код.

Смысл появляется на повторяемости: одно и то же действие, много раз, по одинаковым правилам. Как считаются такие работы, видно в разделе цены.

Коротко

API — язык, на котором программы разговаривают друг с другом напрямую, без человека посередине. Он убирает ручной перенос данных, делает информацию свежей и позволяет действиям происходить круглосуточно. Стоимость интеграции складывается не из самого вызова, а из сопоставления полей, обработки ошибок и журналирования. При малом объёме операций или при отсутствии API у сервиса дешевле оставить ручную работу.