Перейти к содержимому
Разработка и интеграции
Проверено редакцией

Объяснение ошибки API

Вы понимаете, что сломалось — права доступа, лимит запросов или сервер — и что проверить в первую очередь, не дожидаясь разработчика.

Следить за обновлениями

Обновлён ·AgentPoint

Зачем

Интеграция с CRM или маркетплейсом вдруг выдаёт «403» или «429», что это значит и кто должен чинить, понятно только разработчику — заказы и заявки стоят.

Кому?

Владелец магазина или менеджер, когда интеграция с CRM или маркетплейсом вдруг выдала код ошибки.

Подойдёт, если нужно

  • Заказы с Wildberries перестали загружаться: ответ 403, токен недавно обновляли
  • Скрипт получает 429 «слишком много запросов»
  • Bitrix24 или amoCRM не присылает уведомления на ваш адрес
  • После обновления сайта интеграция отвечает 500, 502 или 504
  • Передать разработчику понятное описание проблемы
Когда не подойдёт ↓
  • Отправка запросов к вашему сервису — текст ошибки вы вставляете сами
  • Подбор доступов и обход защиты
  • Точная причина без логов: помощник предлагает порядок проверки

Как пользоваться

  1. 1

    Опишите задачу. Магазин на Wildberries, заказы перестали загружаться в нашу программу. Запрос GET /api/v3/orders/new возвращает 403, в ответе {"error":"access denied","message":"token scope insufficient"}. Токен вчера обновили, а из Postman с другого компьютера всё работало. Что проверить?

  2. 2

    Получите черновик. Наш скрипт отправляет заявки на https://api.example.ru/v1/leads, а сервер отвечает 429, в заголовках Retry-After: 60. Скрипт запускается по расписанию и шлёт 200 заявок каждые 5 секунд. Что делать?

  3. 3

    Проверьте результат. Bitrix24 не присылает уведомления об изменении сделки на https://hooks.myshop.ru/bitrix/deal, в Bitrix пишет «ошибка доставки», а в журнале nginx за последний час пусто. SSL обновляли три дня назад. С чего начать?

Ограничения и данные
Кураторский

Skill проверен модератором перед публикацией в каталоге.

  • Работает только с текстом, который вы вставили.
  • Не подключается к CRM, мессенджерам, 1С, API или файлам в демо.
  • Не вводите пароли, API-ключи и реальные персональные или платёжные данные.
  • Переписку и файлы мы не сохраняем в базе данных — они существуют только в открытом окне демо.
  • Текст запроса и вложений временно передаётся LLM-провайдеру для генерации ответа.
  • Проверяйте результат перед использованием в рабочем процессе.
Политика безопасности →
Для технарей: SKILL.md и экспорт

Установка и экспорт

Скачайте SKILL.md, metadata.json, правило Cursor или адаптер под вашу платформу. Файлы генерируются из текущей версии skill и кешируются в хранилище.

Адаптеры платформ

Codex AGENTS.md
Партнёр
Файл инструкций для OpenAI Codex и совместимых coding agents
Скачать
Staqflow guide
Партнёр
Описание задачи для ИИ-ассистента и system prompt для LLM-узла Staqflow
Скачать
Selarti guide
Партнёр
Инструкция по переносу skill в поле «Инструкция» ИИ-агента Selarti
Скачать
Cursor rule (.mdc)
Правило для Cursor Agent
Скачать
Claude ZIP
SKILL.md + metadata.json в архиве
GigaChat prompt
JSON-шаблон промпта для GigaChat
Скачать
YandexGPT template
JSON-шаблон для YandexGPT / Agent Atelier
Скачать
Dify guide
Инструкция для workflow в Dify
Скачать
n8n guide
Инструкция для automation flow в n8n
Скачать
Flowise / Langflow guide
Рецепт потока для сборки в Flowise или Langflow
Скачать
Ollama Modelfile
Modelfile со встроенным system prompt для локальной модели
Скачать
BotHelp guide
Инструкция по переносу skill в поле «Задачи» AI-агента BotHelp
Скачать
BotMother guide
Инструкция по переносу skill в поле инструкций AI-ассистента BotMother
Скачать

Базовые форматы

SKILL.md
Канонический текст skill
Скачать
metadata.json
Метаданные для адаптеров и каталога
Скачать
Частые вопросы
Помощник видит мои логи?

Нет. Вставьте код ответа, фрагмент тела ответа и контекст запроса. Полные токены и ключи не вставляйте — помощник их не просит.

Чем 401 отличается от 403?

401 — сервис вас не узнал: токена нет, он неверный или просрочен. 403 — отказ в доступе: прав или категории токена не хватает, либо включено ограничение по IP.

Можно ли просто повторить запрос?

При 500, 502, 503 и 504 часто да — с паузами и ограничением числа попыток. При 400, 401, 403, 404 и 422 повтор без исправления запроса ничего не изменит.

Подходит для Bitrix24 и Wildberries?

Да, для общих кодов ошибок и типичных причин. Точные коды и правила конкретного сервиса сверяйте с его документацией.

Платформы
1С
Google Sheets
n8n
PostgreSQL
Разработка
История

1.2.3 — F-pass: seoTitle/seoDescription для карточки.

Похожие навыки

Попробуйте спросить…
Кураторский
Чеклист отладки webhook: доставка CRM→n8n, SSL, nginx 502, подпись, журнал Bitrix24. По симптомам, без вызова endpoint в demo.
Разработка и интеграции
Попробуйте спросить…
Составляет и разбирает регулярные выражения по описанию: строит regex, объясняет по частям, предупреждает о ловушках, даёт тест-кейсы.
Разработка и интеграции
Попробуйте спросить…
Кураторский
Черновик workflow в n8n: узлы, маппинг, чеклист доступов и обработка ошибок.
Разработка и интеграции

Нужно под ваш процесс?

Подстроим навык под ваши офферы, тон и ограничения. Или добавим новый, если такого нет.

Адаптировать под мой бизнес