GW.QUOTA_LIMIT 429 지속 — 응답헤더 Quota-Limit=1 / Period=HOURS, 앱 단위 쿼터 제한 사유 및 해제 문의

[styxkorea]

안녕하세요. 스마트스토어 판매자(2CE)로 직접 개발하여 커머스API를 사용 중입니다.

애플리케이션 정보

• 애플리케이션 ID: 5JFOGX709h7FJFL2Gt2szG
• 앱 상태: 활성 / 인증 유효기간: 2026-10-10까지
• 용도: 자사 어드민의 주문 수집, 문의 조회, 상품 재고 동기화

증상
2026-08-20 16시경부터 현재까지 상품·주문·문의 등 모든 API 그룹에서 429 GW.QUOTA_LIMIT이 반환됩니다. 응답 헤더는 다음과 같습니다.

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

즉 앱 전체가 시간당 1회만 호출 가능한 상태입니다. 실제로 한 시간에 1건만 200이 나오고 나머지는 전부 429입니다. 동일 사업자가 운영하는 다른 스토어의 앱에는 Quota 관련 헤더가 전혀 없고 RateLimit 헤더(replenish-rate 2)만 있습니다.

개발 문서에는 GW.QUOTA_LIMIT이 "API데이터솔루션 구독 판매자(단위: 구독 회차)" 또는 "커머스솔루션 구독 판매자 리소스를 호출하는 개발업체(단위: 1초)"에 적용된다고 되어 있는데, 당사는 판매자 직접 개발이며 단위가 HOURS로 내려오고 있어 어느 경우에 해당하는지 알 수 없습니다.

예시 traceId

• AaAZEmfFfFqg6Nf3i9nAAA^1787127030999^13325492 (2026-08-21 14:40:11 KST, GET /v1/pay-order/seller/product-orders/last-changed-statuses)
• AaAYlkURdt-pnMTBtzPkiw^1787118895419^13802897 (2026-08-21 13:33 KST, GET /v2/products/channel-products/{channelProductNo})

당사 귀책 사항 (투명하게 말씀드립니다)
2026-08-15 ~ 08-20 사이 당사 재고동기화 배치의 버그로 PUT /v2/products/channel-products/{channelProductNo}가 400을 반환하는 상품을 무한 재시도하여 **일 평균 약 25,000건(그중 400 응답 약 11,500건)**의 과다 호출이 발생했습니다. 08-20 16:20에 배치를 중단했고, 현재는 다음과 같이 수정을 완료했습니다.

• 400 원인(요청 페이로드 결함) 수정
• 동일 상품 실패 시 지수 백오프(최대 24시간) 적용
• 429 수신 시 해당 배치 즉시 중단, 재시도 최소화
• 재개 시 호출량은 4분 간격·시간당 수십 건 이내로 제한 예정

문의 드리는 것

1. 현재 적용된 Quota-Limit=1/HOURS 제한이 위 과다호출에 대한 조치인지, 아니면 다른 사유인지
2. 자동 해제되는 제한이라면 해제 조건/시점
3. 수동 해제가 필요한 경우 절차

현재 주문 수집까지 전부 막혀 있어 운영에 지장이 큽니다. 확인 부탁드립니다. 감사합니다.

[commerce-api-naver]

Warning

작성 내용에 민감정보가 포함되어있습니다.

이 공간에 게시하는 모든 내용은 불특정 다수에게 즉시 공개됩니다.
작성하신 내용에 잠재적 문제가 될 수 있는 민감정보가 포함되어있습니다. 직접 게시글을 수정하여 민감정보를 제거해주시기 바랍니다.

• 대상 정보: 애플리케이션 ID

수정 후 우측 상단 'edited ▼'에서 민감정보가 포함된 수정 전 이력도 함께 제거해주시기 바랍니다.

안녕하세요. 커머스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" 값으로 꼭 포함하여야 합니다.

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

문의주신 내용에 답변

1. 현재 적용된 제한은 과다호출이 아닌 비표준 호출로 인해 제한된 상태이며 확인 결과 현재도 비표준 호출로 확인되고 있습니다.
2. 표준 호출로 전환 후 전일 비표준 호출이 단 한 건도 발생하지 않으면 빠르면 익일, 늦어도 2주 이내 자동 복원됩니다.
3. 수동 복원을 진행하더라도 비표준 호출이 재발생하면 다시 제한이 걸릴 수 있어 수동 복원보다는 표준 규격 준수 후 자동 복원되는 방향을 권장드립니다.

감사합니다.