Получение списка заданий на отправку факсов

Получение списка заданий на отправку факсов

Используйте активированную учётную запись MultiTEL API через HTTPS с настроенными для неё учётными данными и ограничениями по IP-адресам. Эта конечная точка возвращает список записей об исходящих факсах, принадлежащих аутентифицированной учётной записи. Получение списка не отправляет факсы и не повторяет их отправку.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode search=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_outbox

Этот обработчик не поддерживает фильтры date_from и date_to. В разделе исходящих факсов портала есть дополнительные фильтры, которые не следует переносить в этот запрос API. Результаты упорядочены по времени создания, от новых к старым, без дополнительной сортировки по идентификатору и без курсора снимка данных.

Просмотр записей о заданиях

Проверяйте как результат HTTP, так и поле status.code в JSON. Успешный ответ содержит response.faxes и response.pagination; в примере используются вымышленные данные. Для пустого почтового ящика возвращается пустой массив faxes со значениями total 0 и total_pages 0.

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 13,
      "uuid": "0123456789abcdef0123456789abcdef",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "status": "queued",
      "pages_requested": 3,
      "pages_sent": 0,
      "cost": "0.07500",
      "result_text": "",
      "created_at": "2026-10-01 12:00:00",
      "sent_at": null,
      "updated_at": "2026-10-01 12:00:00"
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id — числовой идентификатор записи. uuid — отображаемый идентификатор задания; для новых отправок используйте идентификатор задания, возвращаемый send_fax, и сохраняйте его для периодической проверки статуса. В списке могут присутствовать старые записи, поэтому не следует считать, что каждая строка была создана через одну и ту же конечную точку отправки.

status и result_text содержат зафиксированные состояние обработки и сообщение. При формировании этого списка они не приводятся к полному перечислению состояний доставки. Нахождение в очереди означает только нахождение в очереди, а не доставку. Для критически важных документов подтвердите получение у адресата, прежде чем считать факс доставленным или отправлять его повторно.

pages_requested и pages_sent — числовые счётчики. cost сохраняет записанное значение; в качестве резервного значения используется строка 0.00. Не следует считать, что его тип в JSON совпадает с типом стоимости входящего факса. Запись в очереди уже может содержать предварительную оценку стоимости. Ни это значение, ни наличие записи в списке не подтверждают окончательные начисления.

created_at, sent_at и updated_at — сохранённые значения в серверном формате без смещения часового пояса; sent_at может иметь значение null. Список не содержит поля статуса вебхука, которое возвращается отдельной конечной точкой проверки статуса.

Безопасная сверка страниц списка

Ориентируйтесь на pagination.page, limit, total и total_pages. Страницы после последней могут быть пустыми. При появлении новых заданий записи могут перемещаться между страницами во время просмотра. Сохраняйте идентификаторы заданий при объединении страниц; эта конечная точка не гарантирует неизменность снимка данных.

Конфиденциальность и повторные попытки

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