Comprendre pourquoi les en-têtes de fax utilisent l'UTC avec le paramètre send_time dans l'API Fax.Plus

Lorsque vous envoyez un fax via l'API Fax.Plus, vous remarquerez peut-être que l'horodatage affiché dans l'en-tête du fax apparaît en UTC, même si vous incluez un décalage horaire (par exemple, +0900 pour le JST) dans le champ send_time.

Comprendre le paramètre send_time

• Le champ send_time est facultatif.
• S'il est omis, le fax est envoyé immédiatement, et l'horodatage de l'en-tête du fax est généré en UTC, qui est le fuseau horaire standard que nous utilisons.
• S'il est renseigné, send_time vous permet de planifier un fax pour une date et une heure précises, y compris un décalage horaire.
• Format pris en charge : 
  YYYY-MM-DD HH:mm:ss +HHMM
  Exemple :
  "send_time": "2025-12-19 09:00:05 +0900"

Comportement important à connaître

Si la valeur de send_time est déjà passée au moment où la requête API est reçue - ne serait-ce que d'une seconde - le système va :

• Ignorer la valeur de send_time fournie
• Envoyer le fax immédiatement
• Définir l'horodatage de l'en-tête du fax en UTC

Ce comportement garantit un traitement fiable des envois immédiats et évite les échecs ou retards liés à des horaires de planification invalides.

Pourquoi cela peut sembler incohérent

Vous pouvez observer un comportement différent selon l'origine de votre requête API :

• Les environnements locaux peuvent envoyer la requête assez rapidement pour que send_time soit encore dans le futur.
• Les environnements cloud peuvent introduire de légers retards, ce qui fait que send_time est interprété comme déjà écoulé.

Dans ces cas, le fax est traité comme un envoi immédiat, et l'horodatage de l'en-tête utilise l'UTC par défaut.

Comment garantir la préservation de votre fuseau horaire

Pour vous assurer que le fuseau horaire spécifié dans send_time est respecté :

✅ Planifiez toujours le fax légèrement dans le futur
Nous vous recommandons de définir send_time au moins 1 à 2 secondes après l'heure actuelle.

Exemple de bonne pratique :

Heure actuelle : 09:00:00 +0900
send_time :    09:00:02 +0900

Cela garantit que la requête est traitée comme un fax planifié et que le décalage horaire est préservé dans l'en-tête du fax.

Points clés à retenir

• send_time est facultatif
• Les en-têtes de fax utilisent l'UTC par défaut pour les envois immédiats
• Si send_time est déjà passé, il est ignoré
• Planifier ne serait-ce que quelques secondes à l'avance évite le repli sur l'UTC

Si vous avez d'autres questions ou avez besoin d'aide pour résoudre un problème lié à votre intégration API, n'hésitez pas à contacter notre équipe d'assistance.