인증·스코프
API Key 인증 방식과 엔드포인트별 필요 스코프를 설명합니다.
인증 헤더
모든 /api/v1/seller/* 요청에 Authorization: Bearer {API_KEY} 헤더가 필요합니다.
키가 만료·회수된 경우 401 invalid_api_key 또는 api_key_expired를 반환합니다.
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
orders:read
GET /orders, GET /orders/{order_number}
orders:write
PATCH /orders/{order_number} (상태·송장·택배사)
quotes:read
GET /quotes, GET /quotes/{quote_number}
inquiries:read
GET /inquiries
notices:read
GET /notices
settlements:read
GET /settlements
buyers:read
GET /buyers
buyer-tiers:read
GET /buyer-tiers
prices:read
GET /prices
catalogs:read
GET /catalogs
link-leads:read
GET /link-leads (유료 플랜)
플랜 게이트
- 무료 플랜 또는 api_access 미포함 플랜: 403 api_access_denied
- 품목 생성 시 플랜별 품목 수 한도가 적용됩니다