Descargar el documento de un fax saliente

Solicitar el documento

Utilice una cuenta habilitada de la API de MultiTEL. Envíe credenciales HTTP Basic para una cuenta con contraseña, o un token Bearer para una cuenta con token. Los permisos de la cuenta y las restricciones de IP siguen siendo aplicables. No utilice credenciales de los procesos de trabajo internos.

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

Utilice el mismo job_id hexadecimal obligatorio de 32 caracteres que en fax_status. La solicitud del cliente está restringida al propietario autenticado. Este ejemplo guarda por separado las cabeceras y los bytes de la respuesta para que un error de la API no se confunda con un PDF.

Gestionar un archivo o un error en JSON

Si la solicitud se realiza correctamente, se devuelven los bytes sin procesar del documento con las cabeceras Content-Type y Content-Disposition de archivo adjunto, no una estructura envolvente JSON. Compruebe esas cabeceras antes de asignar un nombre al archivo guardado, abrirlo o procesarlo. La respuesta puede ser un PDF, un TIFF o el formato original del archivo cargado, según el documento que esté disponible. Un trabajo en cola puede devolver su archivo de origen antes de la conversión.

En caso de error, se devuelve la estructura envolvente JSON habitual de status/response. El código 400 de la API indica que falta job_id o que su formato es incorrecto; 401 indica que falta la autenticación; 404 indica que el trabajo o su archivo no están disponibles para esta cuenta. Compruebe Content-Type y status.code incluso cuando el estado HTTP sea 200.

Disponibilidad y privacidad

La existencia de un registro del trabajo no garantiza que el archivo se pueda descargar indefinidamente; no se ha verificado ningún plazo de conservación. Cuando sea necesario, guarde los documentos que tenga autorización para conservar en un almacenamiento propio bajo su control. El archivo devuelto puede contener información privada del destinatario. Las descargas no envían un nuevo fax.