Вернуться к документации

Журнал и статусы Outbound

Как найти отправку, прочитать итог, отличить duplicate и проверить доступность данных.

Открыть как Markdown
На этой странице

Откройте журнал

В кабинете выберите Outbound → Requests (/outbound/requests). Список и карточки работают через сессию аккаунта; API-токен нужен внешнему приложению, а не для входа на эту страницу. Удалённое или истёкшее HTTP-содержимое не обязано скрывать строку журнала.

Фильтры

Выберите регион, статус и порядок времени. Фильтры и страница сохраняются в URL; смена фильтра возвращает первую страницу. Список регионов помогает выбирать имя, но запись или выбранный регион могут сохраняться в фильтре даже при временном отказе справочника. Пустой результат с фильтрами не доказывает отсутствие всех отправок.

Карточка списка показывает регион, статус, дату и расход. «—» у расхода означает неизвестное значение, а не ноль. Начисление может приходить асинхронно; баланс проверяйте в Billing.

Значения статуса

Статус Значение
received Задание учтено, итог исполнения ещё не получен
delivering Исполнение началось или остаются попытки
success Исполнитель зафиксировал HTTP-успех
failed Исполнение завершилось неуспехом
rejected Задание отклонено исполнением, например из-за неположительной квоты до первой попытки
duplicate Этот вызов является дублем постановки; смотреть duplicate_of

Сетевой отказ чтения карточки не является отдельным статусом задания. Валидационный ответ API 400 не равен строке журнала rejected. Статус partial относится к Inbound с несколькими получателями, не к этому журналу.

Карточка

Откройте отправку по ID. Сверьте регион, время приёма, исход и дату удаления. Сводка или тела могут быть временно недоступны, пока запрос остаётся видимым в журнале. Нажмите Refresh, чтобы обновить сведения. Эта кнопка не отправляет задание заново и не запускает ручной retry.

Карточка Outbound: успешный статус, сводка, попытка HTTP 200 и кнопки скачивания

Успешная отправка: общий статус, сводка исполнения и попытки показаны отдельно. Демонстрационный кабинет, английский интерфейс. Открыть полный размер.

Дубль

duplicate_of указывает на оригинал в том же аккаунте. Перейдите по ссылке оригинала и разбирайте его попытки. Дубль имеет отдельный ID журнала, но не собственные новые HTTP-данные. API чтения данных дубля может вернуть 409 с duplicate_of; не подставляйте текущие настройки как будто дубль исполнялся заново.

Один оригинал всё равно может иметь несколько HTTP-попыток. Защита от дубля постановки не обеспечивает однократность внешнего эффекта.

Журнал через API

curl --fail-with-body --silent --show-error \ --header "Authorization: Bearer $ADAL_API_TOKEN" \ "$ADAL_API_URL/outbound/requests?status=failed&order=desc&page=1"

Ответ содержит records и pages. Параметры: region — UUID, status — значение из таблицы, order=asc|desc, page — положительный номер. Для карточки используйте GET /outbound/requests/{request_id} без query; она добавляет delete_after. Передавайте пустое тело GET-запроса.

После 202 создание записи асинхронно. При 404 проверьте ID, аккаунт/токен и окружение; для только что принятой отправки повторите чтение позднее. Не интерпретируйте любой 404 как разрешение повторить бизнес-действие с новым ключом.

Истечение

Признак is_deleted и дата delete_after описывают доступность HTTP-данных. Истечение не меняет задним числом успешный внешний эффект и не обнуляет начисленный расход. Нельзя восстановить тело только потому, что строка журнала осталась.

См. диагностику, HTTP-данные, хранение и правила повторов.

Связанная документация