Статус «задание создано» не должен означать «пост опубликован». Храните результат отдельно для каждой площадки и аккаунта, а отказ связывайте с попыткой и редакцией отправленного варианта. Сначала воспроизведите документированный отказ на синтетическом запросе: оператор должен увидеть, что исправить, без доступа к секретным техническим логам.
Разделите отказ проверки, временную недоступность и неизвестный исход после потери ответа. У них разные действия. Если площадка уже приняла запрос, новый 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, затем проверьте разрешённый тестовый аккаунт. При возврате версии сохраняйте историю попыток. Для технического разбора подготовьте классификатор ошибок и пример полного пути до панели: полезный результат — оператор понимает следующее действие, а не просто получает красный значок.