인증·스코프

API Key 인증 방식과 엔드포인트별 필요 스코프를 설명합니다.

인증 헤더

모든 /api/v1/seller/* 요청에 Authorization: Bearer {API_KEY} 헤더가 필요합니다.

키가 만료·회수된 경우 401 invalid_api_key 또는 api_key_expired를 반환합니다.

http
Authorization: Bearer qnc_live_xxxxxxxxxxxxxxxx
Content-Type: application/json

스코프

스코프가 부족하면 403 insufficient_scope가 반환됩니다.

구분설명

products:read

GET /products, GET /products/{prod_code}

products:write

POST /products, PUT /products/{prod_code}

warehouses:read

GET /warehouses

warehouses:write

POST /warehouses, PATCH /warehouses

inventory:read

GET /inventory

inventory:write

PUT /inventory

플랜 게이트

  • 무료 플랜 또는 api_access 미포함 플랜: 403 api_access_denied
  • 품목 생성 시 플랜별 품목 수 한도가 적용됩니다