Почему заголовки факсов отображаются в UTC при использовании параметра send_time в API Fax.Plus

При отправке факса через API Fax.Plus вы можете заметить, что временная метка в заголовке факса отображается в UTC, даже если вы указали смещение часового пояса (например, +0900 для JST) в поле send_time.

Как работает параметр send_time

• Поле send_time является необязательным.
• Если оно не указано, факс отправляется немедленно, а временная метка в заголовке факса формируется в UTC — это стандартный часовой пояс, который мы используем.
• Если поле указано, параметр send_time позволяет запланировать отправку факса на конкретную дату и время, включая смещение часового пояса.
• Поддерживаемый формат: 
  YYYY-MM-DD HH:mm:ss +HHMM
  Пример:
  "send_time": "2025-12-19 09:00:05 +0900"

Важная особенность поведения

Если на момент получения API-запроса значение send_time уже находится в прошлом — даже на одну секунду, — система выполнит следующее:

• Проигнорирует указанное значение send_time
• Отправит факс немедленно
• Установит временную метку заголовка факса в UTC

Такое поведение обеспечивает надёжную обработку немедленных отправок и предотвращает сбои или задержки заданий из-за некорректного времени планирования.

Почему поведение может казаться непоследовательным

Поведение может отличаться в зависимости от того, откуда отправлен API-запрос:

• В локальной среде запрос может отправляться достаточно быстро, поэтому значение send_time всё ещё остаётся в будущем.
• В облачной среде возможны небольшие задержки, из-за которых send_time интерпретируется как уже прошедшее время.

В таких случаях факс обрабатывается как немедленная отправка, а временная метка заголовка по умолчанию устанавливается в UTC.

Как сохранить указанный часовой пояс

Чтобы часовой пояс, указанный в send_time, был учтён:

✅ Всегда планируйте отправку факса с небольшим запасом времени в будущем.
Рекомендуем устанавливать значение send_time как минимум на 1–2 секунды позже текущего времени.

Пример рекомендуемого подхода:

Текущее время: 09:00:00 +0900
send_time:    09:00:02 +0900

Это гарантирует, что запрос будет обработан как запланированный факс, а смещение часового пояса сохранится в заголовке факса.

Основные выводы

• send_time является необязательным параметром
• При немедленной отправке заголовок факса по умолчанию отображается в UTC
• Если значение send_time находится в прошлом, оно игнорируется
• Планирование отправки даже на несколько секунд вперёд предотвращает переход к UTC по умолчанию

Если у вас остались вопросы или нужна помощь с настройкой интеграции API, обратитесь в нашу службу поддержки.