빠른 시작
API Key를 발급한 뒤 첫 REST API 호출을 테스트하는 방법입니다.
준비하기
- 유료 플랜 구독 및 api_access 권한 확인
- 대시보드에서 API Key 발급
- 환경 변수 QNECTOR_API_KEY에 Secret 저장
curl 예제
품목 목록을 조회하는 가장 단순한 호출 예시입니다.
bash
curl -X GET "https://qnector.kr/api/v1/seller/products?page=1&limit=20" \ -H "Authorization: Bearer qnc_live_YOUR_API_KEY" \ -H "Content-Type: application/json"
Node.js 예제
javascript
const API_KEY = process.env.QNECTOR_API_KEY;
const BASE_URL = "https://qnector.kr/api/v1/seller";
async function listProducts() {
const res = await fetch(`${BASE_URL}/products?page=1&limit=20`, {
headers: {
Authorization: `Bearer ${API_KEY}`,
"Content-Type": "application/json",
},
});
const json = await res.json();
if (!res.ok) {
throw new Error(json.errors?.[0]?.message || "API 호출 실패");
}
return json.data;
}응답 형식
성공 시 data에 결과, meta에 페이징 정보가 담깁니다.
json
{
"data": {
"prod_code": "SKU-001",
"prod_name": "샘플 품목",
"price": 15000
},
"meta": { "page": 1, "limit": 20, "total": 150 },
"errors": []
}