Be om dokumentet
Bruk en aktivert konto for MultiTEL sitt API. Send påloggingsopplysninger for HTTP Basic for en passordkonto, eller et token av typen Bearer for en tokenkonto. Kontotillatelser og IP-begrensninger gjelder fortsatt. Ikke bruk påloggingsopplysninger for interne arbeidsprosesser.
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_downloadBruk samme obligatoriske heksadesimale job_id på 32 tegn som for fax_status. Kundeforespørselen kan bare utføres av den autentiserte eieren. Dette eksemplet lagrer svarhodene og svarbytene hver for seg, slik at en feil fra API ikke forveksles med en PDF-fil.
Håndter en fil eller en feil i JSON-format
Ved suksess returneres dokumentets rå byte med svarhodene Content-Type og Content-Disposition for vedlegg, ikke en svarinnpakning i JSON-format. Kontroller disse svarhodene før du gir den lagrede filen et navn, åpner den eller behandler den. Svaret kan være en fil i PDF-format, TIFF-format eller det opprinnelige opplastede formatet, avhengig av hvilket dokument som er tilgjengelig. En jobb i kø kan returnere den opprinnelige kildefilen før konvertering.
Ved feil returneres den vanlige svarinnpakningen i JSON-format med strukturen status/response. Feilkode fra API på 400 betyr at job_id mangler eller har ugyldig format; 401 betyr at autentisering mangler; 404 betyr at jobben eller filen til jobben ikke er tilgjengelig for denne kontoen. Kontroller Content-Type og status.code selv når HTTP-statusen er 200.
Tilgjengelighet og personvern
En registrert jobb garanterer ikke at filen kan lastes ned for alltid; oppbevaringstiden er ikke bekreftet. Lagre dokumenter du har tilgangstillatelse til, på et eget lagringssted du har kontroll over, når det er nødvendig. Den returnerte filen kan inneholde private opplysninger om mottakeren. Nedlastinger sender ikke en ny faks.