Dlaczego nagłówki faksu wyświetlają czas w UTC przy użyciu parametru send_time w Fax.Plus API

Podczas wysyłania faksu za pomocą Fax.Plus API może się zdarzyć, że znacznik czasu wyświetlany w nagłówku faksu jest podany w UTC, nawet jeśli w polu send_time podano przesunięcie czasowe (na przykład +0900 dla JST).

Informacje o parametrze send_time

• Pole send_time jest opcjonalne.
• Jeśli zostanie pominięte, faks zostanie wysłany natychmiast, a znacznik czasu w nagłówku faksu zostanie wygenerowany w UTC, czyli w standardowej strefie czasowej, której używamy.
• Jeśli parametr zostanie podany, send_time umożliwia zaplanowanie faksu na konkretną datę i godzinę, wraz z przesunięciem czasowym.
• Obsługiwany format: 
  YYYY-MM-DD HH:mm:ss +HHMM
  Przykład:
  "send_time": "2025-12-19 09:00:05 +0900"

Ważne zachowanie, o którym warto wiedzieć

Jeśli wartość send_time jest w przeszłości w momencie otrzymania żądania API – nawet o jedną sekundę – system:

• Zignoruje podaną wartość send_time
• Wyśle faks natychmiast
• Ustawi znacznik czasu w nagłówku faksu na UTC

Takie zachowanie zapewnia niezawodne przetwarzanie natychmiastowych transmisji i zapobiega niepowodzeniom lub opóźnieniom zadań spowodowanym nieprawidłowymi czasami planowania.

Dlaczego może to wydawać się niekonsekwentne

Możesz zaobserwować różne zachowania w zależności od miejsca, z którego pochodzi żądanie API:

• Środowiska lokalne mogą wysyłać żądanie wystarczająco szybko, aby send_time był jeszcze w przyszłości.
• Środowiska w chmurze mogą wprowadzać niewielkie opóźnienia, powodując interpretację send_time jako czasu, który już minął.

W takich przypadkach faks jest przetwarzany jako wysyłka natychmiastowa, a znacznik czasu w nagłówku domyślnie przyjmuje wartość UTC.

Jak zapewnić zachowanie strefy czasowej

Aby zapewnić uwzględnienie strefy czasowej podanej w send_time:

✅ Zawsze planuj faks z niewielkim wyprzedzeniem czasowym
Zalecamy ustawienie send_time co najmniej 1–2 sekundy po aktualnym czasie.

Przykład najlepszej praktyki:

Aktualny czas: 09:00:00 +0900
send_time:    09:00:02 +0900

Dzięki temu żądanie zostanie potraktowane jako zaplanowany faks, a przesunięcie czasowe zostanie zachowane w nagłówku faksu.

Najważniejsze informacje

• send_time jest opcjonalny
• Nagłówki faksu domyślnie korzystają z UTC w przypadku natychmiastowych wysyłek
• Jeśli send_time jest w przeszłości, zostaje zignorowany
• Zaplanowanie wysyłki choćby kilka sekund naprzód zapobiega automatycznemu przełączeniu na UTC

Jeśli masz dodatkowe pytania lub potrzebujesz pomocy w rozwiązaniu problemów z integracją API, skontaktuj się z naszym zespołem pomocy technicznej.