429 GW.QUOTA_LIMIT 관련 문의 드립니다.

[yupchaki]

안녕하세요. 항상 고생이 많으십니다.

다름이 아니라 아래 여러분들이 문의 주신 429 GW.QUOTA_LIMIT건 관련하여 저희도 동일한 증상이 발생해
답변주신 내용들로 비표준 호출로 인한 호출 허용량 제한으로 판단하여 2026-08-20 중 '인증 토큰 발급 요청'
API의 연동 규격을 아래와 같이 수정하였습니다.

[조치 내용]
기존에는 필수 파라미터를 쿼리스트링(URL)에 담아 전송하고 있었습니다.
이를 Request body에 application/x-www-form-urlencoded 형식으로 담도록 전면 수정하였고,
수정 후 서버에 배포를 완료하였습니다.

POST /external/v1/oauth2/token
Content-Type: application/x-www-form-urlencoded

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

• 필수 파라미터는 모두 Request body에 포함되며, URL에는 어떠한 파라미터도 포함하지 않습니다.
• grant_type은 client_credentials 고정값으로 전송합니다.
• type=SELF 이므로 account_id 파라미터는 포함하지 않습니다.

토큰 발급 요청 자체는 정상적으로 200 응답을 받고 있으나,
발급받은 토큰으로 호출하는 조회 API는 계속 429가 반환되고 있으며
응답 헤더는 다음과 같이 확인됩니다.

gncp-gw-quota-period : HOURS
gncp-gw-quota-limit : 1
gncp-gw-quota-remaining : 0

이에 현재 상태가

수정 후에도 호출이 여전히 비표준으로 판정되고 있는 것인지, 아니면 이전 비표준 호출로 걸린 제한이 아직 유지되고 있는 것인지 구분되지 않아 문의드립니다. 번거로우시겠지만 확인 한번 부탁 드리겠습니다.

• 수정후 trace id : AaAZEmu1fCiKHd1qk0vPag^1787127032037^6759740

감사합니다.

[commerce-api-naver]

안녕하세요. 커머스API 이민석입니다.

배경

커머스API의 인증 토큰은 OAuth 2.0 기술 표준에 근간하고 있습니다.
이에 지난 2024년서부터 표준 규격에 맞춘 형식 변경과 2025년서부터 강화된 형식에 따른 사용자분들의 확인을 요청 드린 바 있습니다.

커머스API센터 공지사항과 수 차례 개별 이메일 발송(커머스API센터 내 '장애대응이메일')으로 대상 사용자분들께 안내드린 것과 같이 '인증 토큰 발급 요청' API 호출 과정에서의 표준 규격 준수를 요구하고 있습니다.

사용자 셀프 체크 항목

✅ API에서 요구하는 필수 요청 파라미터는 Request body에 모두 포함되어야 합니다.

• URL에 파라미터가 포함되어선 안되며 API가 요구하는 요청 파라미터는 모두 Request payload에 포함하여야 합니다.

✅ HTTP Request header의 Content-Type과 body(payload) 데이터 형식은 x-www-form-urlencoded 형식으로 구성되어야 합니다.

✅ type 파라미터 값에 따라 account_id 파라미터 포함 여부가 결정되어야 합니다.

• type 파라미터 값이 "SELF"인 경우 account_id 파라미터는 요청에 포함하여선 안됩니다.
• type 파라미터 값이 "SELLER"인 경우 대상 스토어의 올바른 스토어 계정 ID/UID가 account_id 파라미터 값에 포함하여야 합니다.

✅ grant_type 파라미터 값은 "client_credentials" 값으로 꼭 포함하여야 합니다.

• 오탈자 및 영문 대/소문자 구분에 유의하세요.

문의주신 내용에 답변

알려주신 호출(Trace ID: AaAZEmu1fCiKHd1qk0vPag^1787127032037^6759740)은 API가 요구하는 형식에 맞게 호출된 건으로 확인됩니다.

비표준 호출에 대한 호출 허용량 제한은 시스템 자동 작업으로 수행되며 전일자의 '[인증] 인증 토큰 발급 요청' API 호출 중 비표준 호출이 단 한 건도 발생하지 않은 경우 오전 중 호출 허용량 복원이 자동으로 진행됩니다.
오늘(8/20) 수정하셨다면 수정 이전 비표준 호출이 남아있을 수 있습니다. 오늘 이후 비표준 호출이 완전히 발생하지 않은 날 다음날 오전서부터 호출 허용량 복원이 자동으로 진행되게 됩니다. (공휴일 포함)