API 요청 시 GW.QUOTA_LIMIT 문의

[behonestar]

커머스 API 호출 시 아래 응답을 받습니다.

HTTP 429
gncp-gw-trace-id: AaAZEmfFfFqg6Nf3i9nAAA^1787127030999^5219611
gncp-gw-quota-period: HOURS
gncp-gw-quota-remaining: 0
gncp-gw-quota-limit: 1

{"code":"GW.QUOTA_LIMIT",
"message":"할당된 시간당 요청량을 초과하였습니다.",
...}

■ 문의

인증 토큰 발급 규격 미준수 시 호출 허용량 제한이 걸릴 수 있다고 확인하였고, 의심되는 부분을 수정하였습니다.

1. 수정 이후 현재 규격을 준수하여 호출하고 있는지 확인 가능할까요?

2. 규격을 준수하도록 정상적으로 수정되었다면 언제쯤 QUOTA가 정상 회복되나요?

[commerce-api-naver]

안녕하세요. 커머스API 김태익입니다.

1. '인증 토큰 발급 요청' API의 OAuth 2.0 표준 규약을 준수하지 않습니다.

오류 원인

'[인증] 인증 토큰 발급 요청' API 호출 내용이 OAuth 2.0 표준 규약을 준수하지 않아 커머스API 이용이 제어된 상태입니다.
지난 2024년부터 기술 규격 변경에 대해 공지사항 및 개별 이메일을 통해 안내드린 바 있으며 기술 규격을 준수하지 않은 경우 호출 허용량이 제한됩니다.

• 인증 토큰 발급 요청 규격 강화 안내
  -공지사항: https://notice.naver.com/notices/cac/15832
  • 인증 토큰 발급 요청 규격 강화 안내 #2573

해결 방법

커머스API Docs를 참고하여 '[인증] 인증 토큰 발급 요청' API가 OAuth 2.0 표준 및 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" 값으로 꼭 포함하여야 합니다.

2. API 연동을 수정하신 후 기술 규격을 준수하여 호출하면 빠르면 익일 늦어도 2주 이내에 정상 수준으로 호출 허용량이 회복될 예정입니다.
   단, 호출 허용량 회복을 위해서는 전일 비표준 호출이 단 한 건도 발생하지 않아야 하므로 모든 호출이 규격을 준수하고 있는지 반드시 확인해주시기 바랍니다.

감사합니다.

[behonestar]

답변 감사합니다 🙂

문의를 남긴 (8/20 11:45) 시점 이후로는 잘못된 부분을 조치하여 아래와 같은 규격으로 토큰 발급 API를 요청하고 있는 상태입니다.

1. '인증 토큰 발급 요청' API의 OAuth 2.0 표준 규약을 준수하지 않습니다.

그럼에도 불구하고 여전히 OAuth 2.0 표준 규약을 준수하지 않는 요청이라는 말씀이실까요?

여전히 비표준 규약의 요청이라면 문제가 되는 부분을 안내해주시면 문제 해결에 큰 도움이 될 것 같습니다.

*최근 trace id : AaAYlkURdt-pnMTBtzPkiw^1787118895419^7140856

POST /external/v1/oauth2/token

Request Headers

Accept: application/json
Content-Type: application/x-www-form-urlencoded
...

Request Body

client_id={CLIENT_ID}&timestamp={TIMESTAMP}&client_secret_sign={CLIENT_SECRET}&grant_type=client_credentials&type=SELF

감사합니다.

[commerce-api-naver]

안녕하세요. 커머스API 김태익입니다.

전달해주신 Trace ID 호출 이력을 확인한 결과 현재 OAuth 2.0 표준 규약을 준수하여 호출하고 계신 것으로 확인됩니다.

다만 2026-08-20 11:20경 비표준 호출이 확인됩니다. 호출 허용량 설정이 복원되려면 전일 비표준 호출이 한 건도 발생하지 말아야 합니다. 오늘(8/20) 수정이 되었다 하더라도 수정 이전에 비표준 호출이 발생하였다면 다음날(8/21)에는 비표준 호출이 집계됩니다. 오늘 이후 비표준 호출이 한 건도 발생하지 않는 날 다음날 오전부터 호출 허용량 설정이 복원 적용됩니다.

감사합니다.