Vérifier le statut d'une tâche de fax

Rechercher votre tâche

Utilisez un compte MultiTEL API activé. Envoyez des identifiants HTTP Basic pour un compte à mot de passe, ou un jeton Bearer pour un compte à jeton. Les autorisations de compte et les restrictions IP s'appliquent toujours. N'utilisez pas les identifiants internes du worker.

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

job_id est requis et doit être l'identifiant hexadécimal de 32 caractères renvoyé par send_fax. Copiez-le exactement. Les requêtes sont limitées au propriétaire authentifié.

Lire le résultat

Lisez à la fois le résultat HTTP et le JSON status.code. Les échecs JSON peuvent arriver avec HTTP 200. Une réponse JSON réussie contient status et response ; les exemples utilisent des données fictives.

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

L'exemple est une tâche en file d'attente, non un fax livré ni un devis de prix. pages_requested est le nombre de pages source détecté ; pages_sent indique la progression enregistrée par le traitement. cost est une chaîne décimale et peut déjà contenir une estimation pendant la file d'attente. result contient le détail du traitement ; webhook_status contient l'état enregistré du rappel. Les horodatages sont des chaînes formatées par le serveur sans décalage de fuseau horaire.

Interrogez avec des intervalles croissants plutôt qu'en boucle serrée. Le traitement peut signaler un état envoyé ou terminé, mais l'audit actuel n'a pas établi de garantie de livraison au destinataire. Pour un document critique, confirmez la réception auprès du destinataire avant de le considérer comme livré ou d'envoyer un doublon. Le cycle de vie actif du worker, les règles finales de facturation et le contrat de rappel sont encore en cours de vérification. Ne supposez pas que l'acceptation en file d'attente ou un identifiant de tâche non vide signifie la livraison.

Erreurs

Le code API 400 signifie job_id manquant ou mal formé ; 401 signifie authentification manquante ; 404 signifie que la tâche n'a pas été trouvée pour ce compte. Ne déduisez pas la propriété à partir du seul identifiant.