что такое api простыми словами и зачем это бизнесу

официант вместо похода на кухню

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

api — тот же официант, только между программами. ваша crm говорит сервису рассылок: «отправь этому клиенту письмо номер три». сервис отвечает: «принято» или «не могу, адрес кривой». ни одна из программ не лезет во внутренности другой — только заказы через официанта по заранее известному меню.

меню здесь — документация api: список того, что у сервиса можно попросить. «отдай список сделок», «создай задачу», «спиши товар с остатков». если чего-то нет в меню — этого не получить, сколько ни проси.

зачем это знать вам, а не программисту

потому что интеграции — это то, за что вы платите деньги, и словарный запас из десяти слов позволяет проверять подрядчика. а ещё потому, что каждое «переносим руками из таблицы в crm» в вашей компании — это место, где api сэкономит часы. типовые связки:

• заявка с сайта → сразу сделка в crm, а не почта, которую менеджер проверяет к обеду;
• оплата прошла → доступ открылся, счёт закрылся, бухгалтерия увидела — без человека;
• остатки на складе → цены и наличие на сайте, всегда актуальные;
• ии-агент → ваша crm: агент не «в целом умный», а знает статус конкретного заказа, потому что спросил через api.

последний пункт — главный. весь прикладной ии держится на api: модель без доступа к вашим системам умеет только красиво разговаривать.

словарик на десять слов

• api — договорённость, как программы просят друг друга что-то сделать.
• запрос — один «заказ официанту»: «отдай клиента с номером 482».
• ответ — что вернулось. данные или ошибка с причиной.
• ключ api — пароль, по которому сервис понимает, кто спрашивает. утёк ключ — чужой человек ходит в ваши данные; храним как пароль от банка.
• вебхук — api наоборот: не вы спрашиваете «есть новые заказы?» каждую минуту, а сервис сам толкает вас в плечо, когда заказ появился.
• документация — то самое меню. страница «для разработчиков» на сайте сервиса.
• интеграция — готовая связка двух сервисов через их api.
• лимиты — сколько запросов в минуту можно. бесплатные тарифы часто душат именно тут.
• rest / json — формат, в котором пишут меню и заказы. вам достаточно знать, что это стандарт: если у сервиса «rest api с json», любой разработчик с ним справится.
• no-code коннектор — кубик в n8n или make, где чей-то api уже прикручен: интеграция мышкой, без программиста (подробнее — в гайде про low-code).

как проверить сервис за пять минут до покупки

выбираете crm, учётку, что угодно — откройте на их сайте раздел «api» или «разработчикам» и посмотрите три вещи:

1. api вообще есть? нет — сервис-тупик: данные будете вытаскивать руками до конца дней.
2. что в меню? видно ли там то, что вам понадобится: сделки, товары, клиенты. если api отдаёт только «список пользователей» — это api для галочки.
3. на каком тарифе доступен? любимый трюк: api только в enterprise-тарифе втрое дороже.

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

что пойдёт не так

• «у нас нет api» у ключевого сервиса. обычно у самописной учётки десятилетней давности. обходные пути существуют, но стоят как маленькая война — закладывайте это в решение «менять систему или прикручивать».
• интеграция сломалась молча. сервис обновил api — связка отвалилась, и об этом никто не узнал, пока за месяц не потерялись заявки. просите подрядчика ставить уведомления об ошибках: это час работы, а спасает недели.
• оценка «сложная интеграция, от 300 тысяч». иногда правда, но проверяется одним вопросом: «что именно сложного — в их api нет нужных методов, или много бизнес-логики поверх?» внятный ответ с конкретикой — работайте. мычание — второе мнение обязательно.

куда это приложить у себя

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