在通过 Fax.Plus API 发送传真时，您可能会注意到，即使您在 send_time 字段中包含了时区偏移量（例如，日本标准时间的 +0900），传真页眉中打印的时间戳仍显示为 UTC 时间。
了解 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仍处于未来时间。 - cloud 环境可能会引入轻微的延迟，导致
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 集成问题，请随时联系我们的支持团队。