Списък със задачите за изходящи факсове

Списък със задачите за изходящи факсове

Използвайте активиран 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. Страниците след последната могат да бъдат празни. Новите задачи могат да преместват записи между страниците, докато ги преглеждате. Запазвайте идентификаторите на задачите, когато обединявате страници; тази крайна точка не гарантира непроменлива моментна снимка.

Поверителност и повторни опити

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