Статус «задание создано» не должен означать «пост опубликован». Храните результат отдельно для каждой площадки и аккаунта, а отказ связывайте с попыткой и редакцией отправленного варианта. Сначала воспроизведите документированный отказ на синтетическом запросе: оператор должен увидеть, что исправить, без доступа к секретным техническим логам.

Разделите отказ проверки, временную недоступность и неизвестный исход после потери ответа. У них разные действия. Если площадка уже приняла запрос, новый create может сделать дубль; если она отклонила содержание, повтор тех же данных без изменения не исправит ошибку. Общий статус «ошибка» скрывает оба различия.

Причина должна вести к следующему действию

КатегорияЧто показать оператору
Неверное содержимоеПоле или правило, требующее исправления
Права или авторизацияНужна проверка подключения выбранного аккаунта
Временный отказНазначенный повтор и ограничение попыток
Неизвестный исходИдёт сверка факта размещения
Часть каналов готоваСписок успешных и проблемных размещений отдельно

В документации Mastodon statuses приведены разные HTTP-ответы, включая 401 для неверной авторизации и 422 для ошибки валидации; проверено 22 октября 2026 года. Это пример конкретного API, а не готовая классификация для каждой соцсети. Адаптер сопоставляет документированные ответы своей площадки с понятными состояниями приложения.

Сохраните безопасный технический след

Условная запись результата:
job ID + variant revision + target account
attempt ID + время
provider code + request ID, если он выдан
category + понятная причина без токена
next_action: исправить | переподключить | ждать | сверить
external post ID: только когда получен достоверно

Не показывайте пользователю сырой ответ API без фильтрации. В нём могут оказаться служебные адреса, параметры и чувствительные данные. Для поддержки оставьте разрешённые поля, а секреты не записывайте изначально. Текст внешней ошибки тоже является недоверенным вводом и требует безопасного отображения в панели.

Нормализация не должна стирать исходный код и происхождение события. Иначе одинаковое сообщение «нет доступа» скроет неверный аккаунт, истёкшее разрешение и изменение прав. Сохраняйте связь с попыткой, чтобы поздний ответ старого задания не перезаписал результат новой редакции.

Проверяйте отказ до интерфейса включительно

  • Ошибка содержимого появляется у конкретного канала.
  • Повтор без исправления не уходит в бесконечный цикл.
  • Временный сбой получает ограниченный план повторов.
  • Потеря ответа даёт неопределённый исход, а не ложное «не отправлено».
  • Позднее событие старой попытки не портит актуальный статус.

Для кампании с несколькими каналами показывайте частичный результат. Успех одного размещения не закрывает всю задачу, а отказ другого не должен провоцировать повтор уже готовых каналов. При ручной кнопке «повторить» оператору нужен ясный список затрагиваемых целей и известный риск неопределённого исхода.

Начните с одного адаптера и набора искусственных ответов его API, затем проверьте разрешённый тестовый аккаунт. При возврате версии сохраняйте историю попыток. Для технического разбора подготовьте классификатор ошибок и пример полного пути до панели: полезный результат — оператор понимает следующее действие, а не просто получает красный значок.

Проверенные источники