API 개요
큐넥터 외부 연동 API는 판매자의 품목·창고·재고를 REST로 조회·수정하고, 주문·문의 등 알림을 Webhook으로 전달합니다.
개요
큐넥터 API는 B2B 판매자가 ERP·자동화 도구와 연동할 때 사용합니다. 품목·창고·재고 REST API와 Webhook을 제공합니다.
이용 조건
① 플랜
유료 플랜(api_access 포함)에서만 API Key 발급 및 /api/v1 호출이 가능합니다.
② API Key
대시보드 > API 연동설정 > API 키발급 탭에서 발급합니다. Secret은 발급·재발급 직후 한 번만 표시됩니다.
③ API 버전
현재 API 버전은 2026-06-26입니다. 응답 헤더 X-Qnector-Api-Version으로 확인할 수 있습니다.
④ 전송 형식
요청·응답 본문은 application/json만 지원합니다. 최대 256KB입니다.
연동 구조
Pull: 외부 시스템이 API Key로 /api/v1/seller/* REST API를 호출합니다.
Push: 주문·문의 등 알림 이벤트를 등록한 Webhook URL로 전송합니다. 자체 서버 연동 시 연결 테스트(webhook_test)로 수신을 확인할 수 있습니다.
- API Key는 Bearer 토큰으로만 인증합니다.
- 다른 판매자의 데이터 접근 시 404를 반환합니다.
Base URL
Base URL
https://qnector.kr/api/v1/seller
리소스 식별
외부 API는 판매자가 쓰는 비즈니스 코드·명칭으로 품목·창고를 식별합니다. 호출·응답 모두 동일한 필드를 사용합니다.
- 품목 상세·수정: GET/PUT /products/{prod_code} (URL 인코딩 필요 시 encodeURIComponent 사용)
- 창고 수정: PATCH body에 warehouse_code로 대상 지정
품목
prod_code(품목코드), prod_name(품목명) — 경로·본문·응답
창고
warehouse_code(창고코드), warehouse_name(창고명)
재고 수정
본문에 prod_code + quantity