인증 토큰 발급 요청 규격 강화 안내

[commerce-api-naver]

API 규격 검증 강화 예정

'[인증] 인증 토큰 발급 요청' API 요청 처리 시 호출 내용 내 기술 규격 검증을 강화할 계획을 갖고 있습니다.
인증 토큰 발급은 API 호출에 가장 기본적인 절차로 검증 강화에 따른 영향이 없도록 꼼꼼하게 확인해보시기 바랍니다.

대상하는 API 규격은 커머스API Docs에서 확인 가능합니다.

반영 예정일

2025년 연내 반영 예정

• 단, 영향 최소화를 위해 2025년 8월 30일까지 점검과 수정 대응 완료를 권장합니다.

영향 대상

[인증] 인증 토큰 발급 요청 (POST /v1/oauth2/token)

사용자 지침

영향 대상 API를 이용한 인증 토큰 발급 요청 시 대상 API가 제시한 기술 규격을 엄격히 준수하여 호출을 구성하는지 점검해보시기 바랍니다.

• API에서 요구하는 필수 요청 파라미터는 Request body(payload)에 모두 포함되어야 합니다.
• HTTP Request header의 Content-Type과 body(payload) 데이터 형식은 x-www-form-urlencoded 형식으로 구성되어야 합니다.
  • [Header] Content-Type: application/x-www-form-urlencoded
  • [Payload] client_id=XXXXX&timestamp=1706671059230&grant_type=client_credentials&...
• type 파라미터 값에 따라 account_id 파라미터 포함 여부가 결정되어야 합니다.
  • [type=SELF] account_id 파라미터는 요청에 포함되어선 안됨
  • [type=SELLER] 올바른 스토어 계정 ID/UID가 account_id 파라미터 값에 포함되어야 함
• grant_type 파라미터 값은 "client_credentials" 값으로 꼭 포함하여야 합니다.