Capire perché le intestazioni fax utilizzano UTC con il parametro send_time nell'API Fax.Plus

Quando invii un fax tramite l'API Fax.Plus, potresti notare che il timestamp riportato nell'intestazione del fax appare in UTC, anche quando includi un offset di fuso orario (ad esempio, +0900 per JST) nel campo send_time.

Capire il parametro send_time

• Il campo send_time è opzionale.
• Se omesso, il fax viene inviato immediatamente e il timestamp dell'intestazione del fax viene generato utilizzando UTC, che è il fuso orario standard che utilizziamo.
• Se fornito, send_time ti consente di pianificare un fax per una data e un'ora specifiche, includendo un offset di fuso orario.
• Formato supportato: 
  YYYY-MM-DD HH:mm:ss +HHMM
  Esempio:
  "send_time": "2025-12-19 09:00:05 +0900"

Comportamento importante da tenere presente

Se il valore di send_time è nel passato nel momento in cui la richiesta API viene ricevuta - anche di un solo secondo - il sistema:

• Ignorerà il valore fornito per send_time
• Invierà il fax immediatamente
• Imposterà il timestamp dell'intestazione del fax su UTC

Questo comportamento garantisce un'elaborazione affidabile delle trasmissioni immediate e evita che i processi non vadano a buon fine o subiscano ritardi a causa di orari di pianificazione non validi.

Perché questo può apparire incoerente

Potresti osservare un comportamento diverso in base a dove ha origine la tua richiesta API:

• Gli ambienti locali potrebbero inviare la richiesta in modo sufficientemente rapido da far sì che send_time sia ancora nel futuro.
• Gli ambienti cloud potrebbero introdurre piccoli ritardi, facendo sì che send_time venga interpretato come già trascorso.

In questi casi, il fax viene elaborato come un invio immediato e il timestamp dell'intestazione utilizza UTC come impostazione predefinita.

Come garantire che il tuo fuso orario venga preservato

Per garantire che il fuso orario specificato in send_time venga rispettato:

✅ Pianifica sempre il fax leggermente nel futuro
Ti consigliamo di impostare send_time con almeno 1–2 secondi di anticipo rispetto all'ora attuale.

Esempio di buona pratica:

Ora attuale: 09:00:00 +0900
send_time:    09:00:02 +0900

Questo garantisce che la richiesta venga trattata come un fax pianificato e che l'offset di fuso orario venga preservato nell'intestazione del fax.

Punti chiave

• send_time è opzionale
• Le intestazioni fax utilizzano UTC come impostazione predefinita per gli invii immediati
• Se send_time è nel passato, viene ignorato
• Pianificare anche solo qualche secondo in anticipo previene il ricorso a UTC

Se hai altre domande o hai bisogno di assistenza per risolvere problemi con la tua integrazione API, non esitare a contattare il nostro team di supporto.