인증 토큰 발급 시 Timestamp 관련 오류 문제

[commerce-api-naver]

Q. 인증 토큰 발급 시 "timestamp 항목은 현재 이전이어야 합니다." 오류를 반환합니다.

A. 요청 파라미터 내 timestamp 값은 표준시 기준 API 호출 시각 이전으로 지정되어야 합니다.

인증 토큰 발급에 필요한 요청 파라미터 중 timestamp 값은 보통 호출 컴퓨터의 로컬 시각(컴퓨터 내부의 현재 시각)을 기준으로 생성합니다.
모든 컴퓨터의 로컬 시각은 시간이 지남에 따라 표준시와 오차가 발생합니다. 이 경우 표준시보다 미래 시점으로 Timestamp 값이 생성될 경우 해당 오류 메시지가 제공될 수 있습니다.
API 호출 컴퓨터에 NTP(Network Time Protocol) 서비스를 활성화하여 컴퓨터의 로컬 시각이 주기적으로 표준시와 동기화될 수 있도록 설정해보시거나, 정확한 표준시로 수동 설정해보시기 바랍니다.

💡 NTP 서비스 설정 환경은 각 운영체제 별로 다를 수 있습니다.

호출 컴퓨터의 운영체제에 따라 NTP 서비스 설정 지원 여부 및 설정 방법은 저마다 다를 수 있습니다. 자세한 내용은 각 운영체제의 제작사로 문의해보시기 바랍니다.
동기화 대상 시간 서버(Time Server)는 신뢰할 수 있는 서버로 직접 선택하시어 설정해보시기 바랍니다.

---

Q. 인증 토큰 발급 시 "timestamp항목의 유효 시간이 만료되었습니다." 오류를 반환합니다.

A. 요청 파라미터 내 timestamp 값이 ①호출 시각 기준 5분 이전 범위를 벗어나진 않았는지, ②13자리(밀리초 타임스탬프)인지 확인해보시기 바랍니다.

1. Timestamp는 표준시 상 호출 시각 기준 5분 이전 범위만 유효합니다.
표준시 상 호출 시각 기준으로 5분 이전의 시간 범위만 유효 Timestamp로 인정됩니다.
너무 오래전에 생성한 Timestamp 값은 아닌지 혹은 컴퓨터의 로컬 시각(컴퓨터 내부의 현재 시각)이 표준시와 오차가 상당하진 않은지 확인해보시기 바랍니다.

• 참고: 표준시와 오차가 상당할 경우 바로 위 내용을 참고하시어 로컬 시각을 수정해보시기 바랍니다.

2. Timestamp는 13자리이어야 합니다.
커머스API 인증 토큰 발급에 필요한 Timestamp는 밀리초(millisecond) 단위를 포함하는 13자리 숫자로 구성되어야 합니다.
초(second) 단위 Timestamp로 생성할 경우 10자리 숫자로 구성되기에 생성한 Timestamp가 13자리 숫자로 구성되어있는지 확인해보시기 바랍니다.

---

(마지막 변경일: 2023년 1월 2일)