Fax.Plus API'sinde send_time Parametresiyle Fax Başlıklarında Neden UTC Kullanıldığını Anlama

Fax.Plus API ile fax gönderirken, send_time alanına bir saat dilimi farkı (örneğin JST için +0900) eklemiş olsanız bile fax başlığına yazdırılan zaman damgasının UTC olarak göründüğünü fark edebilirsiniz.

send_time parametresini anlama

• send_time alanı isteğe bağlıdır.
• Belirtilmezse fax hemen gönderilir ve fax başlığındaki zaman damgası, tarafımızca kullanılan standart saat dilimi olan UTC ile oluşturulur.
• Belirtilirse send_time, bir saat dilimi farkı dahil olmak üzere belirli bir tarih ve saat için fax zamanlamanıza olanak tanır.
• Desteklenen biçim: 
  YYYY-MM-DD HH:mm:ss +HHMM
  Örnek:
  "send_time": "2025-12-19 09:00:05 +0900"

Bilmeniz gereken önemli davranış

API isteği alındığı anda send_time değeri geçmişte kalmışsa (bir saniye bile olsa) sistem şunları yapar:

• Belirtilen send_time değerini yok sayar
• Fax'ı hemen gönderir
• Fax başlığındaki zaman damgasını UTC olarak ayarlar

Bu davranış, anlık gönderimlerin güvenilir şekilde işlenmesini sağlar ve geçersiz zamanlama saatleri nedeniyle işlerin başarısız olmasını veya gecikmesini önler.

Bunun neden tutarsız görünebileceği

API isteğinizin geldiği yere bağlı olarak farklı davranışlar gözlemleyebilirsiniz:

• Yerel ortamlar isteği yeterince hızlı gönderebilir; böylece send_time hâlâ gelecekte olur.
• Cloud ortamları küçük gecikmelere yol açabilir; bu da send_time değerinin zaten geçmiş sayılmasına neden olur.

Bu durumlarda fax anlık gönderim olarak işlenir ve başlıktaki zaman damgası varsayılan olarak UTC olur.

Saat diliminizin korunduğundan nasıl emin olursunuz?

send_time içinde belirtilen saat diliminin dikkate alınmasını sağlamak için:

✅ Fax'ı her zaman biraz ileri bir zamana planlayın
send_time değerini geçerli saatten en az 1-2 saniye sonrasına ayarlamanızı öneririz.

En iyi uygulama örneği:

Geçerli saat: 09:00:00 +0900
send_time:    09:00:02 +0900

Bu, isteğin zamanlanmış bir fax olarak ele alınmasını ve saat dilimi farkının fax başlığında korunmasını sağlar.

Önemli noktalar

• send_time isteğe bağlıdır
• Anlık gönderimlerde fax başlıkları varsayılan olarak UTC kullanır
• send_time geçmişteyse yok sayılır
• Birkaç saniye bile ileriye zamanlamak, UTC'ye geri dönülmesini önler

Başka sorularınız varsa veya API entegrasyonunuzdaki sorunları gidermek için yardıma ihtiyaç duyarsanız destek ekibimizle iletişime geçmekten çekinmeyin.