Статья
API простыми словами: что это и зачем сайту
API — способ, которым одна программа обращается к другой: сайт спрашивает у платёжного сервиса, прошла ли оплата, у учётной системы — сколько товара на складе, у карт — где находится адрес. Посетитель этого не видит, но почти каждый современный сайт работает через такие обращения. Разбираем простыми словами, что такое API, REST, API-ключ и вебхук и зачем всё это бизнесу.
Простыми словами
API расшифровывается как Application Programming Interface — программный интерфейс приложения. Представьте окно справочной: вы задаёте вопрос по установленной форме и получаете ответ, а как устроен архив за окном, вам знать не нужно. API — такое окно для программ: одна отправляет запрос в оговорённом виде, другая возвращает ответ.
Примеры на сайте
- Оплата: сайт создаёт платёж через API платёжного сервиса и узнаёт, прошёл ли он, — подробнее в статье «Эквайринг для сайта».
- Карты: адрес и маршрут показывает API Яндекс Карт — о нём статья «Яндекс Карта на сайте».
- Учёт: товары, цены и остатки приходят из 1С или МойСклада — об этом статья «Интеграция сайта с 1С».
- CRM: заявка с сайта сразу становится сделкой у менеджера.
- Доставка: стоимость и сроки считает API службы доставки.
- Уведомления: сообщения о новых заказах в мессенджер отправляются через API бота.
REST API
REST — самый распространённый в вебе стиль API. Программа обращается к нужному адресу и говорит, что хочет сделать: получить данные, создать, изменить или удалить. Ответ обычно приходит в формате JSON — это текст, который легко читают программы.
Например, запрос GET /api/products/42 может вернуть {"id": 42, "name": "Кружка", "price": 990} — сведения о товаре с номером 42.
API-ключ и токен
Ключ, или токен, — пароль программы. По нему сервис понимает, кто к нему обращается и что ему можно. Обращаться с ключом нужно как с паролем:
- хранить на сервере, а не в коде страницы, который может открыть любой;
- не пересылать в мессенджерах и почте;
- ограничить, где его можно использовать, — например, ключ JavaScript API Яндекс Карт привязывают к домену сайта;
- при утечке сразу отозвать и выпустить новый.
Вебхук
Через API ваш сайт сам спрашивает: «Есть новые заказы?» Вебхук работает наоборот: сервис сам сообщает вашему сайту, что что-то произошло, — отправляет запрос на заранее указанный адрес.
| Что сравниваем | API | Вебхук |
|---|---|---|
| Кто начинает | Ваш сайт спрашивает | Сервис сообщает сам |
| Когда | Когда сайту нужно | Сразу, как случилось событие |
| Пример | Сайт запрашивает остатки товаров | Платёжный сервис сообщает об оплате |
Вебхуки есть у платёжных сервисов, CRM вроде Битрикс24, учётных систем и мессенджеров. Главное правило безопасности: сайт должен проверять, что уведомление пришло от настоящего сервиса, — иначе можно принять поддельное сообщение об оплате.
Что важно бизнесу
- Есть ли у сервиса API. Перед выбором CRM, платёжного сервиса или учётной системы проверьте, что их можно связать с сайтом.
- Лимиты и цены. У многих API есть бесплатный лимит запросов в сутки, а сверх него — тарифы.
- Документация и тестовый режим — по ним разработчик подключает сервис без риска для настоящих заказов.
- Кто следит за связкой. API обновляются, старые версии отключают, и интеграцию время от времени нужно проверять.
Как это делаем мы
В интернет-магазине товары и цены приходят из вашей таблицы или учётной системы — МойСклад или 1С, онлайн-оплату подключаем через платёжный сервис, с которым у вас договор, а заказы приходят в Telegram и на почту. Нестандартные интеграции — с CRM или своими сервисами — считаем отдельно, в смете до старта.