구매자 품목 API

승인된 판매자의 구매 가능 품목·적용 단가를 조회합니다.

엔드포인트

구분설명

GET /products

구매 가능 품목 목록 (products:read)

목록 조회

쿼리: q(검색, 최대 100자), seller_code(사업자번호 필터), page, limit(1~100, 기본 20)

승인(approved)된 판매자의 품목만, 앱과 동일한 가시성·단종·단가 규칙을 적용합니다.

bash

curl "https://qnector.kr/api/v1/buyer/products?q=사과&seller_code=123-45-67890&page=1&limit=20" \
  -H "Authorization: Bearer qnc_buyer_YOUR_API_KEY"

엔드포인트 예시

GET /products

품목 목록 (products:read)

응답 예시 (200)

json

{
  "data": [
    {
      "prod_code": "SKU-001",
      "prod_name": "사과 5kg",
      "seller_code": "123-45-67890",
      "seller_company_name": "샘플 판매자",
      "price": 15000,
      "size_description": "5kg",
      "barcode": "8801234567890",
      "category": "과일",
      "product_status": "in_stock",
      "tax_status": "taxed",
      "min_order_qty": 1,
      "max_order_qty": null,
      "price_display_basis": "vat_included"
    }
  ],
  "meta": { "page": 1, "limit": 20 },
  "errors": []
}

응답 필드

필드	필수여부	자릿수/형식	설명
prod_code	-	string	품목코드
prod_name	-	string	품목명
seller_code	-	string	판매자 사업자번호
seller_company_name	-	string	판매자 상호
price	-	number \| null	구매자에게 적용된 단가(원)
size_description	-	string	규격
barcode	-	string	바코드
category	-	string	분류명
product_status	-	string \| null	품목 상태(in_stock 등)
tax_status	-	string \| null	과세 구분
min_order_qty / max_order_qty	-	number \| null	최소·최대 주문 수량
price_display_basis	-	vat_included \| vat_excluded	단가 표시 기준

제한 사항

상세·생성·수정 API는 1차 범위에서 제공하지 않습니다.
멀티 판매자인 경우 seller_code로 필터링하는 것을 권장합니다.
products:read 스코프와 유료 api_access가 필요합니다.