GW.QUOTA_LIMIT 에러가 발생합니다.

[DeveloperJo]

안녕하세요.

다른 분들과 마찬가지로, 금일(26/08/20) 오전 10시 경부터 QUOTA_LIMIT 오류가 발생하고 있습니다.

토큰 요청 Header 정보

Request Method : POST
Request Header : Array
(
    [0] => Content-Type: application/x-www-form-urlencoded; charset=UTF-8
    [1] => Authorization: Bearer 
)

Response Output : HTTP/2 200 
date: Thu, 20 Aug 2026 05:33:38 GMT
content-type: application/json
content-length: 80
gncp-gw-trace-id: AaAYlkURdt-pnMTBtzPkiw^1787118895419^7017097
gncp-gw-httpclient-responsetime: 37
vary: User-Agent
x-xss-protection: 1; mode=block
referrer-policy: unsafe-url
server: nfront

{"access_token":"34ADyp...","expires_in":5602,"token_type":"Bearer"}

토큰은 정상적으로 발급되었는데, 바로 '판매 상태 변경' 조회 api 요청하면 아래와 같이 결과가 나옵니다.

Request Method : GET
Request Header : Array
(
    [0] => Content-Type: application/json; charset=UTF-8
    [1] => Authorization: Bearer 34ADyp...
)

Response Output : HTTP/2 429 
date: Thu, 20 Aug 2026 05:33:38 GMT
content-type: application/json
content-length: 194
gncp-gw-trace-id: AaAYlkBsfUaXMAWmvWamgw^1787118894419^7089887
gncp-gw-quota-period: HOURS
gncp-gw-quota-remaining: 0
gncp-gw-quota-limit: 1
referrer-policy: unsafe-url
server: nfront

{"code":"GW.QUOTA_LIMIT","message":"할당된 시간당 요청량을 초과하였습니다.","timestamp":"2026-08-20T14:33:38.969+09:00","traceId":"AaAYlkBsfUaXMAWmvWamgw^1787118894419^7089887"}

갑자기 안되는 이유가 있는지.. 확인 부탁드리겠습니다.
감사합니다.

[commerce-api-naver]

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

오류 원인

'[인증] 인증 토큰 발급 요청' API 호출 내용이 OAuth 2.0 표준 규약을 준수하지 않아 커머스API 이용이 제어된 상태이므로 GW.QUOTA_LIMIT 오류가 반환되었습니다.
지난 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" 값으로 꼭 포함하여야 합니다.

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

감사합니다.

[DeveloperJo]

토큰 요청 시에 소스 수정하여 다시 요청했습니다. 정상적인 호출인지 확인 부탁드립니다.

토큰요청

Request Method : POST
Request Header : Content-Type: application/x-www-form-urlencoded

Response Output : HTTP/2 200 
date: Thu, 20 Aug 2026 07:45:21 GMT
content-type: application/json
content-length: 80
gncp-gw-trace-id: AaAYlkBsfUaXMAWmvWamgw^1787118894419^7833600
gncp-gw-httpclient-responsetime: 99
vary: User-Agent
x-xss-protection: 1; mode=block
referrer-policy: unsafe-url
server: nfront

{"access_token":"34AHf3...","expires_in":6700,"token_type":"Bearer"}

토큰요청 후, 주문 변경 상태 조회

Request Method : GET
Request Header : Content-Type: application/json; charset=UTF-8, Authorization: Bearer 34AHf3...

Response Output : HTTP/2 429 
date: Thu, 20 Aug 2026 07:45:21 GMT
content-type: application/json
content-length: 194
gncp-gw-trace-id: AaAYlkURdt-pnMTBtzPkiw^1787118895419^7755224
gncp-gw-quota-period: HOURS
gncp-gw-quota-remaining: 0
gncp-gw-quota-limit: 1
referrer-policy: unsafe-url
server: nfront

{"code":"GW.QUOTA_LIMIT","message":"할당된 시간당 요청량을 초과하였습니다.","timestamp":"2026-08-20T16:45:21.744+09:00","traceId":"AaAYlkURdt-pnMTBtzPkiw^1787118895419^7755224"}

[commerce-api-naver]

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

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

현재 제한은 이전 비표준 호출로 인해 유지되고 있는 상태입니다. 단, 호출 허용량 설정이 복원되려면 전일 비표준 호출이 한 건도 발생하지 말아야 합니다. 오늘 이후 비표준 호출이 한 건도 발생하지 않는 날 다음날 오전부터 호출 허용량 설정이 복원 적용됩니다.

감사합니다.