Laai 'n uitgaande faksdokument af

Versoek die dokument

Gebruik 'n geaktiveerde MultiTEL API-rekening. Stuur HTTP Basic-aanmeldbesonderhede vir 'n wagwoordrekening, of 'n Bearer-token vir 'n tokenrekening. Rekeningtoestemmings en IP-beperkings geld steeds. Moenie die aanmeldbesonderhede van interne werkerprosesse gebruik nie.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode job_id=0123456789abcdef0123456789abcdef \
  --dump-header fax-response.headers --output fax-response.bin \
  https://api.multitel.net/v3/fax_download

Gebruik dieselfde vereiste heksadesimale job_id van 32 karakters as vir fax_status. Die klantversoek word tot die geoutentiseerde eienaar beperk. Hierdie voorbeeld stoor die antwoord se kopvelde en grepe afsonderlik sodat 'n API-fout nie vir 'n PDF aangesien word nie.

Hanteer 'n lêer of 'n JSON-fout

By sukses word rou dokumentgrepe met die aanhegselkopvelde Content-Type en Content-Disposition teruggestuur, nie 'n JSON-omhulsel nie. Gaan daardie kopvelde na voordat jy die gestoorde lêer benoem, oopmaak of verwerk. Die antwoord kan 'n PDF, 'n TIFF of die oorspronklike opgelaaide formaat wees, afhangend van watter dokument beskikbaar is. 'n Taak in die tou kan sy oorspronklike bron voor omskakeling terugstuur.

By mislukking word die gewone JSON-omhulsel vir status/response teruggestuur. API-kode 400 beteken dat job_id ontbreek of verkeerd geformateer is; 401 beteken dat stawing ontbreek; 404 beteken dat die taak of sy lêer nie vir hierdie rekening beskikbaar is nie. Gaan Content-Type en status.code na, selfs wanneer die HTTP-status 200 is.

Beskikbaarheid en privaatheid

'n Taakrekord waarborg nie dat 'n lêer vir altyd afgelaai sal kan word nie; 'n bewaringstydperk is nie bevestig nie. Stoor dokumente waartoe jy gemagtigde toegang het, waar nodig in jou eie berging onder jou beheer. Die teruggestuurde lêer kan privaat inligting oor die ontvanger bevat. Aflaaie stuur nie 'n nuwe faks nie.