Перейти к содержимому
Получить предложение

Данные 16 ноября 2026 6 минут чтения

REST API простыми словами: как устроены запросы, ответы и ограничения

Когда сайт отправляет заявку в CRM, а CRM — данные в таблицу, они почти всегда общаются через REST API. Разработчику это привычно, а руководителю, который заказывает интеграцию, полезно понимать хотя бы основы: что такое метод и код ответа, почему интеграция иногда «падает» и что значит «упёрлись в лимит». Разбираем REST API простыми словами на примере API amoCRM.

REST API: обмен данными между системами

Что такое REST API

API — способ, которым одна программа обращается к другой: «дай список сделок», «создай контакт». REST — самый распространённый стиль такого API в интернете. В нём всё, с чем можно работать, — это ресурсы с адресами, а действие задаётся методом HTTP-запроса — того же протокола, по которому браузер открывает сайты. Что такое API в целом — в статье «Что такое API простыми словами».

Пример адреса ресурса в amoCRM: https://ваш-аккаунт.amocrm.ru/api/v4/leads — это сделки. К адресу добавляются параметры, например сколько записей вернуть.

Мы ведём интеграцию amoCRM по API и разработку виджетов: доработка готовых, связка с внешними системами и решения с нуля.

Методы: что сделать с ресурсом

GET
получить данные: список сделок или одну сделку
POST
создать: новую сделку, контакт, задачу
PATCH
изменить часть полей: сумму сделки, этап, ответственного
PUT
заменить запись целиком (встречается реже)
DELETE
удалить

Данные в запросе и ответе обычно передаются в формате JSON — текст из пар «название: значение», который легко читают и программы, и люди. Подробнее — в статье «JSON: что это».

Коды ответов: что пошло не так

На каждый запрос сервер отвечает трёхзначным кодом. По нему видно, что произошло, ещё до чтения ответа:

200, 201, 204
всё прошло: данные получены, запись создана, изменение принято
400
ошибка в запросе: не то поле, не тот формат
401
не авторизован: токен устарел или неверен
403
доступ запрещён: нет прав или доступ заблокирован
404
не найдено: неверный адрес или запись удалена
429
слишком много запросов: превышен лимит
500, 502, 504
ошибка или перегрузка на стороне сервера: запрос стоит повторить позже

Хорошая интеграция обрабатывает эти коды сама: при 401 обновляет токен, при 429 ждёт и повторяет, при 5xx делает несколько повторов с паузой и пишет в журнал, если не получилось. Плохая — молча теряет данные.

Авторизация и лимиты

Чтобы API знал, кто к нему обращается, запросы подписывают токеном — длинным ключом доступа. В amoCRM для этого используется OAuth 2.0: интеграция получает токен после того, как администратор аккаунта разрешит ей доступ. О ключах — в статье «API-ключ: что это».

У любого API есть лимиты. У amoCRM, по документации:

Запросов в секунду
не более 7 на одну интеграцию и до 50 на весь аккаунт
При превышении
ответ 429; при многократном нарушении аккаунт блокируется, и все запросы получают 403
Записей в одном запросе
при создании и изменении — не более 250, рекомендуется не больше 50; при чтении — до 250, у части методов до 500

Поэтому массовую выгрузку или загрузку делят на порции и делают паузы между запросами — иначе интеграция, которая работала на десяти сделках, сломается на десяти тысячах.

REST API и вебхуки

REST API — это когда ваша система спрашивает: «есть ли новые сделки?». Вебхук — наоборот: CRM сама присылает сообщение, когда что-то произошло. Хорошая интеграция часто использует оба: вебхук говорит «сделка изменилась», а по API забираются подробности. Подробнее — в статье «Вебхук: что это».

Интеграции и виджеты под ключ

Мы делаем интеграции и виджеты для amoCRM и Kommo по API: связку с внешней системой, доработку готового виджета или решение с нуля. Перед стартом — короткое ТЗ и вилка по часам, разработка в вашем аккаунте, проверка на реальных данных и документ о том, что сделано, — чтобы следующая доработка не начиналась с расследования. Ставка — 4 000 ₽ в час по фактическим часам. О том, как подойти к интеграции, — в статье «Интеграция систем: способы и схемы».

Коротко

REST API — ресурсы с адресами и методы GET, POST, PATCH, DELETE, данные в JSON, ответ с кодом: 2xx — успех, 4xx — ошибка в запросе или доступе, 429 — лимит, 5xx — сбой сервера. Надёжная интеграция обновляет токен, соблюдает лимиты, повторяет запросы при сбоях и пишет журнал.

Частые вопросы

Способ, которым программы обмениваются данными через интернет: всё, с чем можно работать, — ресурсы с адресами, а действие задаётся методом запроса — GET получить, POST создать, PATCH изменить, DELETE удалить.
Слишком много запросов: превышен лимит. Нужно подождать и повторить запрос, а в интеграции — делить работу на порции и делать паузы. В amoCRM лимит — не более 7 запросов в секунду на интеграцию и до 50 на аккаунт.
Через REST API ваша система сама запрашивает данные; вебхук — сообщение, которое сервис присылает сам, когда что-то произошло. В интеграциях их часто используют вместе.

Теги: #rest api #rest api что это #методы rest api #коды ответов http #интеграция по api

Converssion CRM — официальный партнёр amoCRM с 2017 года. Внедряем и сопровождаем amoCRM, делаем собственные виджеты для амоМаркета, чат-ботов, ИИ-агентов, сайты и рекламу. Услуги · Кейсы клиентов · Виджеты

Кейсы Converssion CRM

Как мы решали похожие задачи

Данные 6 минут чтения · 16 ноября 2026 Заявка Услуга «Разработка по API»