Объяснение ошибки API
Сокращает время диагностики интеграций без senior-разработчика на каждый 403, 429 или 500 — даёт понятное объяснение и чеклист действий.
Обновлён ·AgentPoint
Бесплатно·Обновлён ·Автор: AgentPoint
Платформы:1СGoogle Sheetsn8n
Зачем
Ошибки API тормозят интеграции: 403, 429 и webhook timeouts непонятны владельцу бизнеса и junior-разработчику, простой простаивает.
Подойдёт, если нужно
- Разбор 401 Unauthorized и проблем с токеном
- Объяснение 403 Forbidden (scope, IP, права CRM)
- Диагностика 429 Too Many Requests и backoff
- 500/502/504 после деплоя или при нагрузке
- Webhook Bitrix24/amoCRM не доходит до endpoint
Не подойдёт, если нужно
Когда не подойдёт ↓
- Выполнения запросов к вашему API из демо
- Обхода security-политик и подбора credentials
- Гарантированного root cause без логов
- Юридической оценки SLA
- Выполнения запросов к вашему API из демо
- Обхода security-политик и подбора credentials
- Гарантированного root cause без логов
- Юридической оценки SLA
Как пользоваться
- 1
Опишите задачу. Wildberries Seller API, GET /api/v3/orders/new → 403. Body: {"error":"access denied","message":"token scope insufficient"}. Токен обновляли вчера, в Postman с другого IP работало. Объясни ошибку и дай чеклист диагностики.
- 2
Получите черновик. POST https://api.example.ru/v1/leads → 429 Too Many Requests. Headers: Retry-After: 60, X-RateLimit-Remaining: 0. Cron шлёт 200 запросов каждые 5 секунд. Что делать?
- 3
Проверьте результат. Bitrix24 webhook onCrmDealUpdate не доходит на https://hooks.myshop.ru/bitrix/deal. В Bitrix «ошибка доставки», nginx access log пустой час. SSL Let's Encrypt обновлялся 3 дня назад. С чего начать диагностику?
Для технарей: SKILL.md и экспорт
Установка и экспорт
Скачайте SKILL.md, metadata.json, правило Cursor или адаптер под вашу платформу. Файлы генерируются из текущей версии skill и кешируются в хранилище.
Адаптеры платформ
Частые вопросы
Skill видит мои логи автоматически?
Нет. Вставьте status code, фрагмент response body и контекст запроса. Не вставляйте полные токены и секреты — skill маскирует упоминания credentials в ответе.
Чем 401 отличается от 403?
401 — не прошла аутентификация (нет/неверный/истёкший token). 403 — аутентификация может быть OK, но нет прав на ресурс, IP заблокирован или недостаточный scope.
Можно ли retry при 500?
Часто да — с exponential backoff и лимитом попыток. При 400/401/403/404/422 retry без исправления запроса обычно бессмысленен. Skill укажет рекомендацию для вашего кейса.
Подходит для Bitrix24 и Wildberries?
Да, как общий runbook по HTTP-кодам плюс типичные гипотезы для CRM и marketplace API. Точные коды ошибок провайдера сверяйте с их официальной документацией.
Платформы
История
v1.1.0 — expanded SKILL.md: HTTP error taxonomy, diagnostic checklists, webhook branch, retry guidance, 3 examples. Research: MDN, LightBox API, Habr/OTUS RFC9457, NetworkSpy, Exolve.
Частые вопросы
Skill видит мои логи автоматически?
Нет. Вставьте status code, фрагмент response body и контекст запроса. Не вставляйте полные токены и секреты — skill маскирует упоминания credentials в ответе.
Чем 401 отличается от 403?
401 — не прошла аутентификация (нет/неверный/истёкший token). 403 — аутентификация может быть OK, но нет прав на ресурс, IP заблокирован или недостаточный scope.
Можно ли retry при 500?
Часто да — с exponential backoff и лимитом попыток. При 400/401/403/404/422 retry без исправления запроса обычно бессмысленен. Skill укажет рекомендацию для вашего кейса.
Подходит для Bitrix24 и Wildberries?
Да, как общий runbook по HTTP-кодам плюс типичные гипотезы для CRM и marketplace API. Точные коды ошибок провайдера сверяйте с их официальной документацией.
Похожие навыки
Нужно под ваш процесс?
Подстроим навык под ваши офферы, тон и ограничения. Или добавим новый, если такого нет.
Адаптировать под мой бизнес