MultiTEL
Développeurs

GET/v3/fax_download?job_id={job_id}

Télécharger le document d’un fax sortant

Récupérez le document disponible pour l’une de vos tâches d’envoi de fax.

Sur cette page
  1. Demander le document
  2. Traiter un fichier ou une erreur JSON
  3. Disponibilité et confidentialité

Demander le document

Utilisez un compte API MultiTEL activé. Envoyez les identifiants HTTP Basic pour un compte utilisant un mot de passe, ou un jeton Bearer pour un compte utilisant un jeton. Les autorisations du compte et les restrictions d’adresse IP continuent de s’appliquer. N’utilisez pas les identifiants des processus de traitement internes.

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

Utilisez le même job_id hexadécimal obligatoire de 32 caractères que pour fax_status. La requête du client est réservée au propriétaire authentifié. Cet exemple enregistre séparément les en-têtes et les octets de la réponse afin qu’une erreur API ne soit pas prise pour un fichier PDF.

Traiter un fichier ou une erreur JSON

En cas de réussite, la réponse contient les octets bruts du document avec les en-têtes de pièce jointe Content-Type et Content-Disposition, et non une enveloppe JSON. Vérifiez ces en-têtes avant de nommer, d’ouvrir ou de traiter le fichier enregistré. Selon le document disponible, la réponse peut être au format PDF, TIFF ou au format d’origine du fichier téléversé. Une tâche en file d’attente peut renvoyer son fichier source d’origine avant la conversion.

En cas d’échec, la réponse contient l’enveloppe JSON status/response habituelle. Le code API 400 indique que job_id est absent ou mal formé ; 401 indique l’absence d’authentification ; 404 indique que la tâche ou son fichier n’est pas disponible pour ce compte. Vérifiez Content-Type et status.code, même lorsque le statut HTTP est 200.

Disponibilité et confidentialité

L’existence d’un enregistrement de tâche ne garantit pas que le fichier restera téléchargeable indéfiniment ; aucune durée de conservation n’a été vérifiée. Au besoin, enregistrez les documents auxquels vous êtes autorisé à accéder dans votre propre espace de stockage, sous votre contrôle. Le fichier renvoyé peut contenir des informations privées sur le destinataire. Les téléchargements n’entraînent pas l’envoi d’un nouveau fax.