Warum Faxköpfe mit dem Parameter send_time in der Fax.Plus API UTC verwenden

Wenn Sie ein Fax über die Fax.Plus API senden, bemerken Sie möglicherweise, dass der im Faxkopf gedruckte Zeitstempel in UTC angezeigt wird, selbst wenn Sie im Feld send_time einen Zeitzonen-Offset (zum Beispiel +0900 für JST) angeben.

Den Parameter send_time verstehen

• Das Feld send_time ist optional.
• Wird es weggelassen, wird das Fax sofort gesendet, und der Zeitstempel im Faxkopf wird anhand von UTC erzeugt, der von uns verwendeten Standardzeitzone.
• Wird es angegeben, ermöglicht Ihnen send_time, ein Fax für ein bestimmtes Datum und eine bestimmte Uhrzeit zu planen, einschließlich eines Zeitzonen-Offsets.
• Unterstütztes Format: 
  YYYY-MM-DD HH:mm:ss +HHMM
  Beispiel:
  "send_time": "2025-12-19 09:00:05 +0900"

Wichtiges Verhalten, das Sie beachten sollten

Liegt der Wert von send_time zu dem Zeitpunkt, an dem die API-Anfrage empfangen wird, in der Vergangenheit – selbst um nur eine Sekunde –, wird das System:

• Den angegebenen send_time-Wert ignorieren
• Das Fax sofort senden
• Den Zeitstempel im Faxkopf auf UTC setzen

Dieses Verhalten sorgt für eine zuverlässige Verarbeitung sofortiger Übertragungen und verhindert fehlgeschlagene oder verzögerte Aufträge aufgrund ungültiger Planungszeiten.

Warum dies inkonsistent erscheinen kann

Je nachdem, woher Ihre API-Anfrage stammt, können Sie unterschiedliches Verhalten beobachten:

• Lokale Umgebungen senden die Anfrage möglicherweise schnell genug, sodass send_time noch in der Zukunft liegt.
• Cloud-Umgebungen können kleine Verzögerungen verursachen, wodurch send_time bereits als abgelaufen interpretiert wird.

In diesen Fällen wird das Fax als Sofortversand verarbeitet, und der Zeitstempel im Faxkopf wird standardmäßig auf UTC gesetzt.

Wie Sie sicherstellen, dass Ihre Zeitzone erhalten bleibt

Um sicherzustellen, dass die in send_time angegebene Zeitzone berücksichtigt wird:

✅ Planen Sie das Fax immer geringfügig in der Zukunft
Wir empfehlen, send_time mindestens 1–2 Sekunden nach der aktuellen Uhrzeit anzusetzen.

Beispiel für bewährte Praxis:

Aktuelle Uhrzeit: 09:00:00 +0900
send_time:    09:00:02 +0900

Dadurch wird sichergestellt, dass die Anfrage als geplantes Fax behandelt wird und der Zeitzonen-Offset im Faxkopf erhalten bleibt.

Wichtigste Erkenntnisse

• send_time ist optional
• Faxköpfe verwenden bei Sofortversand standardmäßig UTC
• Liegt send_time in der Vergangenheit, wird es ignoriert
• Eine Planung auch nur wenige Sekunden im Voraus verhindert den Rückfall auf UTC

Wenn Sie weitere Fragen haben oder Hilfe bei der Fehlerbehebung Ihrer API-Integration benötigen, kontaktieren Sie gerne unser Support-Team.