Fax.Plus API에서 send_time 매개변수를 사용할 때 fax 헤더가 UTC를 사용하는 이유 이해하기

Fax.Plus API를 통해 fax를 보낼 때, send_time 필드에 시간대 오프셋(예: JST의 경우 +0900)을 포함하더라도 fax 헤더에 표시되는 타임스탬프가 UTC로 표시되는 것을 확인할 수 있습니다.

send_time 매개변수 이해하기

• send_time 필드는 선택 사항입니다.
• 생략하면 fax가 즉시 전송되며, fax 헤더 타임스탬프는 저희가 사용하는 표준 시간대인 UTC를 기준으로 생성됩니다.
• 제공하면 send_time을 통해 시간대 오프셋을 포함하여 특정 날짜와 시간에 fax를 예약할 수 있습니다.
• 지원 형식: 
  YYYY-MM-DD HH:mm:ss +HHMM
  예:
  "send_time": "2025-12-19 09:00:05 +0900"

알아두어야 할 중요한 동작

API 요청을 수신하는 시점에 send_time 값이 이미 과거인 경우(단 1초라도) 시스템은 다음과 같이 동작합니다:

• 제공된 send_time을 무시합니다
• fax를 즉시 전송합니다
• fax 헤더 타임스탬프를 UTC로 설정합니다

이러한 동작은 즉시 전송의 안정적인 처리를 보장하고, 잘못된 예약 시간으로 인한 전송 실패나 지연을 방지합니다.

이러한 현상이 일관되지 않게 보이는 이유

API 요청이 어디에서 시작되는지에 따라 다른 동작을 관찰할 수 있습니다:

• 로컬 환경에서는 요청이 충분히 빠르게 전송되어 send_time이 여전히 미래일 수 있습니다.
• cloud 환경에서는 약간의 지연이 발생하여 send_time이 이미 지난 것으로 해석될 수 있습니다.

이러한 경우, fax는 즉시 전송으로 처리되며 헤더 타임스탬프는 기본적으로 UTC로 설정됩니다.

시간대가 유지되도록 하는 방법

send_time에 지정된 시간대가 적용되도록 하려면:

✅ 항상 fax를 약간 미래로 예약하세요
현재 시간보다 최소 1~2초 이후로 send_time을 설정하는 것을 권장합니다.

모범 사례 예시:

현재 시간: 09:00:00 +0900
send_time:    09:00:02 +0900

이렇게 하면 요청이 예약된 fax로 처리되어 fax 헤더에 시간대 오프셋이 유지됩니다.

핵심 요약

• send_time은 선택 사항입니다
• 즉시 전송 시 fax 헤더는 기본적으로 UTC를 사용합니다
• send_time이 과거인 경우 무시됩니다
• 단 몇 초라도 앞서 예약하면 UTC로 대체되는 것을 방지할 수 있습니다

추가 질문이 있거나 API 통합 문제 해결에 도움이 필요하시면 언제든지 저희 지원팀에 문의해 주세요.