Status des Faxauftrags prüfen

Ihren Auftrag nachschlagen

Verwenden Sie ein aktiviertes MultiTEL-API-Konto. Senden Sie HTTP Basic-Anmeldedaten für ein Passwortkonto oder ein Bearer-Token für ein Token-Konto. Kontoberechtigungen und IP-Beschränkungen gelten weiterhin. Verwenden Sie keine internen Worker-Anmeldedaten.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode job_id=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_status

job_id ist erforderlich und muss die 32-stellige hexadezimale Kennung sein, die von send_fax zurückgegeben wird. Kopieren Sie sie genau. Anfragen sind auf den authentifizierten Eigentümer beschränkt.

Das Ergebnis lesen

Lesen Sie sowohl das HTTP-Ergebnis als auch JSON status.code. JSON-Fehler können mit HTTP 200 eintreffen. Eine erfolgreiche JSON-Antwort enthält status und response; die Beispiele verwenden fiktive Daten.

{
  "status": {
    "code": 200,
    "msg": "Fax status"
  },
  "response": {
    "job_id": "0123456789abcdef0123456789abcdef",
    "from_number": "+12125550123",
    "to_number": "+12125550124",
    "status": "queued",
    "result": "",
    "pages_requested": 3,
    "pages_sent": 0,
    "cost": "0.07500",
    "webhook_status": "",
    "created_at": "2026-10-23 10:00:00",
    "updated_at": "2026-10-23 10:00:00"
  }
}

Das Beispiel ist ein Auftrag in der Warteschlange, kein zugestelltes Fax und kein Preisangebot. pages_requested ist die erkannte Seitenzahl der Quelle; pages_sent meldet den von der Verarbeitung aufgezeichneten Fortschritt. cost ist eine Dezimalzeichenfolge und kann bereits eine Schätzung enthalten, während der Auftrag in der Warteschlange ist. result enthält Verarbeitungsdetails; webhook_status enthält den aufgezeichneten Callback-Status. Zeitstempel sind serverseitig formatierte Zeichenfolgen ohne Zeitzonenversatz.

Fragen Sie mit zunehmenden Intervallen ab statt in einer engen Schleife. Die Verarbeitung kann einen gesendeten oder abgeschlossenen Zustand melden, das aktuelle Audit hat jedoch keine Zustellungsgarantie an den Empfänger festgestellt. Bestätigen Sie bei einem kritischen Dokument den Empfang beim Empfänger, bevor Sie es als zugestellt behandeln oder ein Duplikat senden. Der aktive Worker-Lebenszyklus, die endgültigen Abrechnungsregeln und der Callback-Vertrag werden noch überprüft. Gehen Sie nicht davon aus, dass die Annahme in die Warteschlange oder eine nicht leere Job-ID eine Zustellung bedeutet.

Fehler

API-Code 400 bedeutet fehlende oder ungültig formatierte job_id; 401 bedeutet fehlende Authentifizierung; 404 bedeutet, dass der Auftrag für dieses Konto nicht gefunden wurde. Leiten Sie die Eigentümerschaft nicht allein aus der Kennung ab.