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

[commerce-api-naver]

안녕하세요.
네이버 커머스API센터입니다.

앞선 2025년서부터 인증 토큰 발급의 기술 규격 검증 강화와 관련하여 변경된 기술 규격을 준수해 주실 것을 부탁드리고 있습니다.
최근 규격 미준수 호출이 발생하는 일부 애플리케이션에 제한적 API 호출 설정을 적용하고 있어 다시 한 번 기술 규격 준수를 부탁드리고자 합니다.

이 조치는 지난 2025년 5월 23일 변경 소식을 알려드린 이후 해당 사용자분들께 수차례 개별적으로 안내드렸으나 현재까지 변경된 기술 규격을 충족하지 못하는 애플리케이션만을 대상으로 적용하고 있습니다.

조치 내용

커머스API센터로 발급받으신 '내 스토어 애플리케이션' 이용 시 '[인증] 인증 토큰 발급 요청' API의 요청이 요구 조건을 만족하지 못하는 경우 기존 호출량과 무관하게 API 호출을 시간당 1회로 제한합니다.

점검 및 조치 방법

아래 기술 규격을 엄격히 준수하여 호출을 구성하고 있는지 점검과 수정을 부탁드립니다.
자세한 규격 명세는 커머스API Docs에서 확인하실 수 있습니다.

• API에서 요구하는 필수 요청 파라미터는 Request body(payload)에 모두 포함되어야 합니다.
• HTTP Request 헤더의 Content-Type과 body(payload) 데이터 형식은 x-www-form-urlencoded 형식으로 구성되어야 합니다.
• type 파라미터 값에 따라 account_id 파라미터 포함 여부가 결정되어야 합니다.
  • type이 "SELF"인 경우 account_id 파라미터는 요청에 포함되어서는 안 됩니다.
  • type이 "SELLER"인 경우 대상 스토어의 올바른 '스토어 계정 ID/UID'를 account_id 값에 포함하여야 합니다.
    (참고: '내 스토어 애플리케이션'은 항상 type 파라미터 값을 "SELF"로만 사용합니다)
• grant_type 파라미터 값은 조건에 관계없이 "client_credentials" 값으로 반드시 포함하여야 합니다. (필수)

제한/복원의 기준과 주의사항

전일자 '[인증] 인증 토큰 발급 요청' API의 전체 요청 내용의 기술 규격 준수 여부를 기준으로 당일 제한과 복원을 결정하고 있습니다.

• 오늘 제한 대상이더라도 전체 API 요청에서 기술 규격 준수가 확인될 경우 빠르면 다음날 오전서부터 제한이 해제됩니다. (평상 수준 복원)
• ⚠️ 기술 규격 미준수 호출이 한 건이라도 포함된 경우 제한 대상으로 포함되거나 기존 제한이 유지될 수 있습니다. 모든 호출 IP, API 호출 포인트에 수정 내용이 반영되었는지 꼼꼼히 확인해 보시기 바랍니다.

---

커머스API는 표준 기술 규격을 준수하여 사용자분들께 규격화된 API 서비스를 제공하는데 노력을 기울이고 있습니다.
요구하는 기술 규격을 준수하여 스마트스토어 운영과 커머스API 서비스 이용에 영향이 없도록 꼼꼼한 확인을 부탁드립니다.

감사합니다.

(마지막 변경일: 2026년 8월 21일)