Три буквы, которые звучат на каждой встрече про автоматизацию. «У них открытый API», «а API у этого сервиса есть?», «через API подтянем». Обычно собеседник в этот момент кивает и надеется, что дальше объяснится само. Но само не объясняется.
Разберём на пальцах. Кода не будет, аналогия будет, а в конце — три вопроса, которые стоит задавать до того, как вы купили сервис и обнаружили, что он ни с чем не дружит.
Меню в ресторане
Вы пришли в кафе. На кухню вас не пустят, к плите не подойти, рецепты вам не покажут. Вместо этого дают меню: вот что мы умеем приготовить, вот как это называется, вот что нужно уточнить — прожарка, без лука, здесь или с собой. Вы говорите официанту позицию из меню, через какое-то время получаете готовое блюдо.
API — это ровно такое меню у программы. Список того, о чём её можно попросить и правила, как именно просить. «Дай карточку клиента по номеру телефона». «Создай сделку вот с такими полями». «Покажи остатки на таком-то складе». Внутрь никого не пускают, но обязательно ответят.
Само сокращение расшифровывается как «интерфейс прикладного программирования» и эта расшифровка не помогла ещё никому. Держите в голове меню (или уже привычное всем — АПИ).
Чем это отличается от вебхука
Если вы читали статью про вебхуки, разница в одной фразе:
- вебхук — система сама сообщает новость: «пришла заявка», «прошла оплата»;
- API — мы сами спрашиваем: «а какие заявки есть за вчера?», «а этот клиент у вас есть?».
Звонок в дверь против похода в магазин. И то и другое нужно, просто в разных случаях.
Новость, на которую надо реагировать сразу, приходит вебхуком. А вот «загрузить всю базу клиентов разом», «сверить остатки на конец дня», «создать сто задач по списку» — это API: тут нужны не новости, а действия по нашей инициативе.
В нормальной интеграции работают оба. Вебхук приносит событие, API следом достаёт подробности и раскладывает их по местам.
Где вы уже этим пользуетесь
Почти на каждом сайте, который вы открывали сегодня:
- курс валют в интернет-магазине — магазин спросил его у банка через API;
- карта с адресом на странице контактов — сайт попросил её у картографического сервиса;
- расчёт доставки прямо в корзине — запрос в службу доставки, ответ за секунду;
- вход «через Госуслуги» или «через VK» — обмен по API между сайтом и сервисом;
- отправка чека в налоговую из онлайн-кассы.
Никто ничего не копировал руками. Одна программа спросила у другой и получила ответ.
Почему владельцу бизнеса это важно знать
Потому что от одной строчки в описании сервиса зависит, во что вам обойдётся автоматизация через год.
Есть API — есть будущее. Сервис с нормальным API можно связать с чем угодно: с CRM, с 1С, с телефонией, с отчётом в мессенджере. Сервис без API — остров. Данные из него вынимаются только руками или выгрузкой в файл, а это значит: человек, время, ошибки, опоздания.
Красивый интерфейс и наличие API — вещи не связанные. Бывает симпатичная программа, из которой нельзя достать ничего, кроме Excel-выгрузки по кнопке. И бывает страшненькая учётная система, которая отдаёт наружу всё, что попросишь. Для автоматизации вторая лучше.
Это вопрос стоимости, а не возможности. Связать можно почти всё. Разница в том, что при живом API работа занимает дни, а без него — начинаются «танцы с бубном»: разбор выгрузок, чтение писем, эмуляция действий человека и т.д. Такие связки я тоже делаю, но говорю честно: они обходятся дороже и ломаются чаще, в отличие от API.
Ложка дёгтя (куда ж без неё)
Три вещи, о которых обычно не пишут в рекламных буклетах.
«API есть» не равно «есть то, что нужно». Меню бывает коротким. В нём может не оказаться того самого поля или того самого действия, ради которого всё затевалось. Проверяется это до покупки — за полчаса чтения документации.
Лимиты. Почти каждый сервис ограничивает, сколько запросов в секунду/минуту можно задать. Пока данных мало — это незаметно. Когда база выросла, интеграция вдруг начинает спотыкаться на ровном месте. Это не поломка, просто упёрлись в потолок, о котором никто не спросил заранее.
Версии. API живёт и меняется. Сервис вправе объявить, что старый способ отключается с такого-то числа. У аккуратного вендора об этом предупреждают за месяцы, у неаккуратного вы узнаёте по факту. Именно поэтому связка, собранная на скорую руку, любит разваливаться через полгода — я разобрал этот сценарий подробно: почему интеграция «на коленке» ломается через полгода.
Что делать вам
Уметь читать документацию не нужно. Достаточно трёх вопросов — задавайте их до того, как выбрали сервис и оплатили год вперёд:
- У вас есть API и открытая документация на него? Ответ «есть, вот ссылка» — хороший знак. Ответ «есть, обсудим индивидуально» — обычно означает «за отдельные деньги».
- Что именно через него доступно? Не «всё», а конкретно: клиенты, сделки, остатки, документы. Список смотрится за один вечер, а экономит месяцы и деньги.
- Какие ограничения по числу запросов? Чтобы не выяснить это в момент, когда бизнес вырос.
А когда дело дойдёт до конкретной задачи, сэкономить время и деньги помогает подготовка — семь вопросов из чек-листа.
Если ответы на все три получены до подписания договора, дальше почти любую задачу можно решить спокойно. Если после — иногда приходится менять сервис и вот это уже дорого.
Не уверены, дружит ли ваш нынешний сервис с остальными? Напишите мне, посмотрим вместе — обычно понятно за один разговор. Обращайтесь, решим вашу задачу!