Waarom faxheaders UTC gebruiken bij de send_time-parameter in de Fax.Plus API

Wanneer u een fax verstuurt via de Fax.Plus API, ziet u mogelijk dat de tijdstempel in de faxheader in UTC wordt weergegeven, ook als u een tijdzoneverschil (bijvoorbeeld +0900 voor JST) opgeeft in het veld send_time.

De send_time-parameter begrijpen

• Het veld send_time is optioneel.
• Als het wordt weggelaten, wordt de fax direct verzonden en wordt de tijdstempel in de faxheader gegenereerd in UTC, de standaardtijdzone die wij gebruiken.
• Als het wordt opgegeven, kunt u met send_time een fax inplannen voor een specifieke datum en tijd, inclusief een tijdzoneverschil.
• Ondersteund formaat: 
  YYYY-MM-DD HH:mm:ss +HHMM
  Voorbeeld:
  "send_time": "2025-12-19 09:00:05 +0900"

Belangrijk gedrag om rekening mee te houden

Als de waarde van send_time op het moment van ontvangst van het API-verzoek in het verleden ligt - al is het maar één seconde - zal het systeem:

• De opgegeven send_time negeren
• De fax direct verzenden
• De tijdstempel in de faxheader instellen op UTC

Dit gedrag zorgt voor een betrouwbare verwerking van directe verzendingen en voorkomt mislukte of vertraagde taken door ongeldige planningstijden.

Waarom dit inconsistent kan lijken

U kunt ander gedrag waarnemen, afhankelijk van waar uw API-verzoek vandaan komt:

• Lokale omgevingen kunnen het verzoek snel genoeg versturen, zodat send_time nog in de toekomst ligt.
• In cloudomgevingen kunnen kleine vertragingen optreden, waardoor send_time wordt geïnterpreteerd als reeds verstreken.

In deze gevallen wordt de fax verwerkt als een directe verzending en valt de tijdstempel in de header terug op UTC.

Zo zorgt u ervoor dat uw tijdzone behouden blijft

Zo zorgt u ervoor dat de in send_time opgegeven tijdzone wordt gerespecteerd:

✅ Plan de fax altijd iets in de toekomst in
Wij raden aan send_time minstens 1-2 seconden vooruit te zetten ten opzichte van de huidige tijd.

Voorbeeld van best practice:

Huidige tijd: 09:00:00 +0900
send_time:    09:00:02 +0900

Zo wordt het verzoek behandeld als een ingeplande fax en blijft het tijdzoneverschil behouden in de faxheader.

Belangrijkste punten

• send_time is optioneel
• Faxheaders gebruiken standaard UTC bij directe verzendingen
• Als send_time in het verleden ligt, wordt het genegeerd
• Zelfs een paar seconden vooruit inplannen voorkomt de terugval op UTC

Als u aanvullende vragen hebt of hulp nodig hebt bij het oplossen van problemen met uw API-integratie, neem dan gerust contact op met ons ondersteuningsteam.