Lister les tâches d’envoi de fax

Lister les tâches d’envoi de fax

Utilisez un compte API MultiTEL activé via HTTPS, avec les identifiants et les restrictions d’adresses IP configurés pour ce compte. Ce point de terminaison liste les enregistrements de fax sortants appartenant au compte authentifié. La consultation de la liste ne transmet ni ne renvoie de fax.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode search=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_outbox

Ce gestionnaire ne prend en charge ni le filtre date_from ni le filtre date_to. La boîte d’envoi du portail propose des filtres supplémentaires qui ne doivent pas être repris dans cette requête API. Les résultats sont triés par date et heure de création, du plus récent au plus ancien, sans tri secondaire par identifiant ni curseur permettant de parcourir un instantané.

Consulter les enregistrements des tâches

Examinez à la fois le résultat HTTP et le champ status.code du contenu JSON. Une réponse réussie contient response.faxes et response.pagination ; les données de l’exemple sont fictives. Une boîte vide renvoie un tableau faxes vide, avec total à 0 et total_pages à 0.

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 13,
      "uuid": "0123456789abcdef0123456789abcdef",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "status": "queued",
      "pages_requested": 3,
      "pages_sent": 0,
      "cost": "0.07500",
      "result_text": "",
      "created_at": "2026-10-01 12:00:00",
      "sent_at": null,
      "updated_at": "2026-10-01 12:00:00"
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id est l’identifiant numérique de l’enregistrement. uuid est l’identifiant visible de la tâche ; utilisez l’identifiant de tâche renvoyé par send_fax pour les nouveaux envois et conservez-le pour les interrogations périodiques de l’état. La liste peut contenir des enregistrements plus anciens ; ne supposez donc pas que toutes les lignes ont été créées via le même point de terminaison d’envoi.

status et result_text contiennent l’état de traitement et le message enregistrés. Cette liste ne les normalise pas en une énumération exhaustive des états de livraison. Un fax en file d’attente est en attente de traitement, et non livré. Pour les documents critiques, confirmez la réception auprès du destinataire avant de considérer le fax comme livré ou d’en envoyer un duplicata.

pages_requested et pages_sent sont des décomptes numériques. cost conserve la valeur stockée, avec la chaîne de caractères 0.00 comme valeur de repli ; ne supposez pas que son type JSON est identique à celui du coût dans la boîte de réception. Un enregistrement en file d’attente peut déjà contenir une estimation. Ni cette valeur ni la présence d’un enregistrement dans la liste ne permettent de déterminer la facturation définitive.

created_at, sent_at et updated_at sont des valeurs stockées au format du serveur, sans décalage de fuseau horaire ; sent_at peut avoir la valeur null. La liste ne contient pas le champ d’état du webhook renvoyé par le point de terminaison distinct de consultation de l’état.

Regrouper les résultats paginés en toute sécurité

Appuyez-vous sur pagination.page, limit, total et total_pages. Les pages au-delà de la dernière peuvent être vides. De nouvelles tâches peuvent déplacer des enregistrements d’une page à l’autre pendant la consultation. Conservez les identifiants des tâches lorsque vous regroupez les pages ; ce point de terminaison ne garantit pas un instantané stable des données.

Confidentialité et nouvelles tentatives

Les enregistrements de la boîte d’envoi contiennent des métadonnées téléphoniques privées. Limitez les personnes autorisées à les consulter et évitez de journaliser les réponses complètes. L’absence d’un enregistrement dans la liste ne prouve pas l’échec d’une demande d’envoi : vérifiez l’identifiant de tâche conservé et la boîte d’envoi du portail avant de renouveler la demande. Un nouvel envoi peut créer un autre fax susceptible d’être facturé. Les garanties définitives concernant le processus d’exécution, la facturation, les notifications de rappel et la conservation des données restent à l’étude.