Rate limits

Лимиты применяются per партнёр, не per IP.

Endpoint	Лимит
POST /v1/inbound/leads	60 req/min
GET /v1/inbound/leads/{externalId}/status	120 req/min

Окно лимита — sliding window 60 секунд.

Что мы возвращаем при превышении

HTTP/1.1 429 Too Many Requests
Retry-After: 18
Content-Type: application/json

{
  "error": "rate_limit_exceeded",
  "message": "Try again in 18 seconds"
}

Retry-After — секунды до следующего разрешённого запроса.

Как обрабатывать на своей стороне

1. При 429 остановите отправку этого endpoint'а на Retry-After секунд.
2. Если лидов накопилось много — складывайте в очередь и сливайте по 60 / минута.
3. Не делайте агрессивный retry без backoff — вы только усугубите ситуацию.

Хочется больше — пишите менеджеру

Лимиты можно поднять под объём трафика. Стандартные значения покрывают ~85k лидов в сутки, чего хватает большинству партнёров. Если ваш план выше — обсудим индивидуально.

Burst-режим

Внутри секунды можно отправлять до 10 параллельных запросов — это не считается нарушением. Лимит применяется к суммарному количеству за 60 секунд.

Дашборд лимитов

В личном кабинете CRM (для менеджера) есть страница /integrations → ваш партнёр → вкладка «Throttle» — там видно текущее использование квоты в реальном времени. Если вам нужен доступ — напишите менеджеру.