REST API простыми словами: как устроены запросы, ответы и ограничения
Когда сайт отправляет заявку в CRM, а CRM — данные в таблицу, они почти всегда общаются через REST API. Разработчику это привычно, а руководителю, который заказывает интеграцию, полезно понимать хотя бы основы: что такое метод и код ответа, почему интеграция иногда «падает» и что значит «упёрлись в лимит». Разбираем REST API простыми словами на примере API amoCRM.
Что такое REST API
API — способ, которым одна программа обращается к другой: «дай список сделок», «создай контакт». REST — самый распространённый стиль такого API в интернете. В нём всё, с чем можно работать, — это ресурсы с адресами, а действие задаётся методом HTTP-запроса — того же протокола, по которому браузер открывает сайты. Что такое API в целом — в статье «Что такое API простыми словами».
Пример адреса ресурса в amoCRM: https://ваш-аккаунт.amocrm.ru/api/v4/leads — это сделки. К адресу добавляются параметры, например сколько записей вернуть.
Мы ведём интеграцию amoCRM по API и разработку виджетов: доработка готовых, связка с внешними системами и решения с нуля.
Методы: что сделать с ресурсом
Данные в запросе и ответе обычно передаются в формате JSON — текст из пар «название: значение», который легко читают и программы, и люди. Подробнее — в статье «JSON: что это».
Коды ответов: что пошло не так
На каждый запрос сервер отвечает трёхзначным кодом. По нему видно, что произошло, ещё до чтения ответа:
Хорошая интеграция обрабатывает эти коды сама: при 401 обновляет токен, при 429 ждёт и повторяет, при 5xx делает несколько повторов с паузой и пишет в журнал, если не получилось. Плохая — молча теряет данные.
Авторизация и лимиты
Чтобы API знал, кто к нему обращается, запросы подписывают токеном — длинным ключом доступа. В amoCRM для этого используется OAuth 2.0: интеграция получает токен после того, как администратор аккаунта разрешит ей доступ. О ключах — в статье «API-ключ: что это».
У любого API есть лимиты. У amoCRM, по документации:
Поэтому массовую выгрузку или загрузку делят на порции и делают паузы между запросами — иначе интеграция, которая работала на десяти сделках, сломается на десяти тысячах.
REST API и вебхуки
REST API — это когда ваша система спрашивает: «есть ли новые сделки?». Вебхук — наоборот: CRM сама присылает сообщение, когда что-то произошло. Хорошая интеграция часто использует оба: вебхук говорит «сделка изменилась», а по API забираются подробности. Подробнее — в статье «Вебхук: что это».
Интеграции и виджеты под ключ
Мы делаем интеграции и виджеты для amoCRM и Kommo по API: связку с внешней системой, доработку готового виджета или решение с нуля. Перед стартом — короткое ТЗ и вилка по часам, разработка в вашем аккаунте, проверка на реальных данных и документ о том, что сделано, — чтобы следующая доработка не начиналась с расследования. Ставка — 4 000 ₽ в час по фактическим часам. О том, как подойти к интеграции, — в статье «Интеграция систем: способы и схемы».
REST API — ресурсы с адресами и методы GET, POST, PATCH, DELETE, данные в JSON, ответ с кодом: 2xx — успех, 4xx — ошибка в запросе или доступе, 429 — лимит, 5xx — сбой сервера. Надёжная интеграция обновляет токен, соблюдает лимиты, повторяет запросы при сбоях и пишет журнал.
Частые вопросы
Converssion CRM — официальный партнёр amoCRM с 2017 года. Внедряем и сопровождаем amoCRM, делаем собственные виджеты для амоМаркета, чат-ботов, ИИ-агентов, сайты и рекламу. Услуги · Кейсы клиентов · Виджеты







