Ошибки и лимиты

Коды ошибок

Код	Значение	Что делать
400	Невалидный запрос	проверьте тело и форматы (UUID, SemVer, HTTPS)
401	Не авторизован	токен истёк/невалиден — SDK обновит сам
403	Запрещено	нет прав на операцию (роль, tenant, scope)
404	Не найдено	сущность не существует или удалена
409	Конфликт	дубликат (email, slug)
422	Не прошла автовалидация	см. reviewNote в ответе платформы
429	Слишком много запросов	соблюдайте rate limits, включите backoff
5xx	Ошибка сервера	повторите с экспоненциальной задержкой

Rate limits

• публичные endpoints: 60 запросов/мин на приложение;
• запись (create/update/delete): 30 запросов/мин;
• webhooks: 120 доставок/мин на подписку.

При превышении возвращается 429 + заголовок Retry-After.

Пагинация

Списочные методы принимают page и pageSize:

const { items, total, page, pageSize } = await sdk.contacts.search({
  page: 2,
  pageSize: 50,
});

Максимальный pageSize — 100.

CORS

• Разрешённые origin: https://app.maxscrm.com, https://*.maxscrm.com, домены, указанные в манифесте (homepage, entrypointUrl);
• песочница: https://sandbox.maxscrm.com.

Таймауты

SDK использует таймаут 15 секунд на запрос и автоматический ретрай для идемпотентных операций (GET) — один повтор.