빠른 시작

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": []
}