Controleer de status van een faxtaak

Zoek uw faxtaak op

Gebruik een ingeschakeld MultiTEL API-account. Stuur HTTP Basic-inloggegevens voor een wachtwoordaccount, of een Bearer-token voor een tokenaccount. Accountrechten en IP-beperkingen blijven van toepassing. Gebruik geen interne inloggegevens van het werkproces.

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

job_id is verplicht en moet de hexadecimale identificatie van 32 tekens zijn die door send_fax wordt teruggegeven. Kopieer deze exact. Verzoeken zijn beperkt tot de geauthenticeerde eigenaar.

Lees het resultaat

Lees zowel het HTTP-resultaat als het JSON-veld status.code. JSON-fouten kunnen met HTTP 200 binnenkomen. Een geslaagd JSON-antwoord bevat status en response; de voorbeelden gebruiken fictieve gegevens.

{
  "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"
  }
}

Het voorbeeld is een taak in de wachtrij, geen afgeleverde fax of prijsopgave. pages_requested is het gedetecteerde aantal bronpagina’s; pages_sent geeft de voortgang weer die tijdens de verwerking is vastgelegd. cost is een tekenreeks met een decimaal getal en kan al een schatting bevatten terwijl de taak in de wachtrij staat. result bevat verwerkingsdetails; webhook_status bevat de vastgelegde callbackstatus. Tijdstempels zijn door de server opgemaakte tekenreeksen zonder tijdzone-offset.

Vraag de status met steeds langere tussenpozen op in plaats van in een snelle lus. De verwerking kan de status verzonden of voltooid melden, maar de huidige controle heeft geen garantie op aflevering aan de ontvanger vastgesteld. Bevestig bij een belangrijk document de ontvangst met de ontvanger voordat u het als afgeleverd beschouwt of nogmaals verstuurt. De levenscyclus van het actieve werkproces, de definitieve factureringsregels en het callbackcontract worden nog gecontroleerd. Neem niet aan dat acceptatie in de wachtrij of een niet-lege taak-ID aflevering betekent.

Fouten

API-code 400 betekent dat job_id ontbreekt of onjuist is opgebouwd; 401 betekent dat authenticatie ontbreekt; 404 betekent dat de taak niet voor dit account is gevonden. Leid eigendom niet alleen uit de identificatie af.