Что такое API простыми словами и зачем он нужен бизнесу

Что такое API простыми словами? Это договорённость между двумя программами о том, как они обмениваются данными: какой запрос отправить, в каком формате и что придёт в ответ. Когда заявка с сайта сама попадает в CRM, остатки из 1С подтягиваются в каталог, а статус доставки СДЭК виден в личном кабинете покупателя, всё это работает через API. Ниже разберём, как это устроено, чем отличаются виды API, что такое API-ключ и что спросить у подрядчика до начала интеграции. Технических знаний не нужно.

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

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

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

Принципы работы API: запрос и ответ

Любое обращение к API состоит из двух частей: программа-клиент отправляет запрос, сервер возвращает ответ. Упрощённо запрос сайта в службу доставки выглядит так:

1. Адрес (эндпоинт) — куда стучаться, например https://api.service.ru/v2/calculator.
2. Метод — что сделать: получить данные (GET), создать (POST), изменить (PUT/PATCH), удалить (DELETE).
3. Авторизация — ключ или токен, по которому сервис понимает, кто спрашивает.
4. Данные запроса — например, город отправления, город получения и вес посылки.

Ответ приходит обычно в формате JSON — это текст, который легко читают программы:

{"tariff": "склад-склад", "price": 420, "days_min": 2, "days_max": 4}

Сайт берёт эти цифры и показывает покупателю: «Доставка 420 ₽, 2–4 дня». Весь обмен занимает доли секунды. Если что-то пошло не так, сервер возвращает код ошибки: 401 — неверный ключ, 404 — не найдено, 429 — слишком много запросов, 500 — сбой на стороне сервиса. Грамотная интеграция обрабатывает каждый такой случай, а не просто «падает».

Для чего нужен API бизнесу: реальные сценарии в России

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

1С ↔ сайт

Выгрузка каталога, цен и остатков из 1С на сайт и обратная загрузка заказов. Исторически для этого используется обмен в формате CommerceML, у современных конфигураций есть REST-интерфейс OData и возможность опубликовать собственные HTTP-сервисы. Подробнее о вариантах — на странице интеграции сайта с 1С и CRM.

CRM ↔ формы сайта

Заявка с формы, звонок из коллтрекинга или сообщение из чата создают сделку в Битрикс24, amoCRM или RetailCRM с меткой источника. Менеджер видит лид через несколько секунд, а маркетинг получает честную аналитику по каналам.

Оплата: ЮKassa, СБП, банковский эквайринг

Сайт через API платёжного сервиса создаёт платёж, покупатель платит картой или по СБП, а сервис уведомляет сайт об успешной оплате. После этого заказ автоматически меняет статус, а чек уходит через онлайн-кассу по 54-ФЗ. Как это устроено на практике, описано в разделе про подключение эквайринга и онлайн-оплаты.

Доставка: СДЭК, Почта России, Яндекс Доставка

Расчёт стоимости в корзине, выбор пункта выдачи на карте, создание накладной и отслеживание статуса — всё через API служб доставки.

Яндекс и VK

API Яндекс Метрики и Директа позволяют собирать отчёты по рекламе в одну таблицу, API Яндекс Карт — показывать адреса и считать маршруты, VK API — публиковать посты и принимать сообщения сообщества. Сюда же относятся сервисы проверки контрагентов и автозаполнения реквизитов по ИНН вроде DaData.

REST, SOAP, GraphQL и вебхуки: в чём разница для бизнеса

Это не разные «технологии на выбор», а разные стили, в которых сервис предоставляет свой API. Выбирать обычно не приходится: вы работаете с тем, что даёт 1С, банк или служба доставки. Но понимать разницу полезно, чтобы оценить сложность и сроки.

Что такое API-ключ и как его хранить

API-ключ (токен) — это длинная строка символов, по которой сервис узнаёт, кто к нему обращается и что ему разрешено. По сути это пароль вашей компании для программы. У ЮKassa это идентификатор магазина и секретный ключ, у СДЭК — пара Account и Secure password, по которой выдаётся временный токен, у DaData — ключ из личного кабинета.

Что будет при утечке ключа

Последствия зависят от прав ключа. Утечка ключа к картам или подсказкам обычно означает, что кто-то израсходует ваш лимит или деньги с баланса. Утечка ключа CRM откроет доступ к базе клиентов, то есть к персональным данным. Это уже ответственность по 152-ФЗ и штрафы. Через секретный ключ платёжного сервиса злоумышленник может, например, оформлять возвраты.

Правила хранения

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

Лимиты и платность API

Почти у любого API есть ограничения, и их стоит учесть до запуска, а не после первого сбоя.

• Лимиты частоты. Например, VK API ограничивает количество запросов в секунду на один токен. Если его превысить, сервис начнёт отвечать ошибками.
• Суточные квоты. На бесплатном тарифе DaData доступно 10 000 запросов в сутки, общих для подсказок и других сервисов подписки. После исчерпания лимита сервис до 00:00 следующего дня отвечает ошибкой 403, и автозаполнение на сайте молча перестаёт работать.
• Платные тарифы. Коммерческое использование карт, геокодирования, проверки контрагентов и распознавания документов обычно платное. Плата берётся по подписке или за каждый запрос.
• Комиссии вместо платы за API. Платёжные сервисы и службы доставки не берут денег за сам API: они зарабатывают на комиссии с платежа или стоимости отправления.

Практический вывод: оцените, сколько запросов в сутки будет в пиковый день (распродажа, рекламная кампания), и сравните с лимитом тарифа. Для тяжёлых запросов вроде справочника пунктов выдачи подрядчик должен предусмотреть кэширование, чтобы не обращаться к сервису на каждый показ страницы.

Документация API: как понять, что интеграция возможна

Документация — это инструкция к API: список методов, форматы данных, коды ошибок, лимиты. По её качеству можно заранее оценить риск проекта.

• Хороший признак: публичная документация на русском, примеры запросов, тестовая среда (песочница) и журнал изменений версий.
• Тревожный признак: документация в PDF от 2016 года, нет песочницы, поддержка отвечает неделями. Закладывайте больше времени и бюджета.
• Если у вашей учётной системы или самописной CRM API нет совсем, сначала придётся его разработать. Это отдельный этап, и он часто дороже самой интеграции.

Что спросить у подрядчика перед интеграцией по API

Интеграция — это не «подключить модуль», а процесс со своими рисками. Задайте эти вопросы до подписания договора:

1. С какими API вы уже работали? Есть ли опыт именно с нашей версией 1С, CRM или платёжного сервиса?
2. Какие данные и в каком направлении будут передаваться, как часто: в реальном времени, по расписанию, по событию?
3. Что происходит, если сторонний сервис недоступен? Есть ли очередь и повторные попытки, или заказ просто потеряется?
4. Как будут храниться ключи и кто будет владельцем аккаунтов в сервисах?
5. Будет ли журнал обмена (логи), чтобы разобраться, где «застрял» заказ?
6. Как интеграция переживёт обновление 1С или новую версию API сервиса? Кто и на каких условиях её поддерживает?
7. Как проверяется результат: тестовая среда, сценарии приёмки, пробные оплаты?

Эти пункты стоит зафиксировать в техническом задании на интеграцию сайта с внешними сервисами. Тогда оценка и сроки будут опираться на конкретный объём работ.

Типичные ошибки при работе с API

• Нет обработки ошибок. Сервис доставки ответил ошибкой, а покупатель видит пустую корзину без объяснений. Нужны понятные сообщения и запасной сценарий.
• Нет мониторинга. Обмен с 1С остановился в пятницу, а заметили это в понедельник по жалобам клиентов. Нужны уведомления о сбоях ответственному.
• Игнорирование версий. Сервисы отключают старые версии API. Если подрядчик не следит за рассылками, интеграция однажды перестаёт работать.
• Дубли и расхождения. Нет единого идентификатора товара или клиента в обеих системах, и данные начинают двоиться.
• Одна учётная запись на всё. Один ключ с полными правами на все интеграции, записанный на бывшего сотрудника.
• Интеграция «на коленке» без документации. Новый подрядчик не может понять, как всё устроено, и предлагает переделать с нуля.

Чек-лист перед запуском интеграции по API

• Понятно, какую ручную работу убирает интеграция и сколько часов в месяц это экономит
• Проверено, что у обеих систем есть API, изучены документация и тестовая среда
• Посчитаны лимиты и стоимость тарифов при пиковой нагрузке
• Аккаунты и ключи оформлены на компанию, у ключей минимальные права
• Секретные ключи хранятся только на сервере
• Предусмотрены обработка ошибок, повторные попытки и уведомления о сбоях
• Ведётся журнал обмена, есть документация по интеграции
• Договорились о поддержке после запуска и реакции на обновления API

Итог: зачем владельцу бизнеса понимать API

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