견적 API

판매자 견적 목록·상세 조회 API입니다. 생성·수정은 제공하지 않습니다.

엔드포인트

구분설명

GET /quotes

견적 목록 (quotes:read)

GET /quotes/{quote_number}

견적 상세 (quotes:read)

목록 조회

쿼리: page, limit(1~50, 기본 20). 식별자는 quote_number입니다.

bash
curl "https://qnector.kr/api/v1/seller/quotes?page=1&limit=20" \
  -H "Authorization: Bearer qnc_live_YOUR_API_KEY"

엔드포인트 예시

GET /quotes

견적 목록 (quotes:read)

응답 예시 (200)

json
{
  "data": [
    {
      "quote_number": "Q-20260626-001",
      "title": "6월 견적",
      "status": "draft",
      "recipient_label": "테스트 구매자",
      "total_amount": 30000,
      "created_at": "2026-06-26T09:00:00Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1 },
  "errors": []
}

상세 조회

경로의 quote_number로 단일 견적을 조회합니다. 품목 라인에 prod_code가 포함됩니다.

bash
curl "https://qnector.kr/api/v1/seller/quotes/Q-20260626-001" \
  -H "Authorization: Bearer qnc_live_YOUR_API_KEY"

엔드포인트 예시

GET /quotes/{quote_number}

견적 상세 (quotes:read)

응답 예시 (200)

json
{
  "data": {
    "quote_number": "Q-20260626-001",
    "title": "6월 견적",
    "status": "draft",
    "total_amount": 30000,
    "quote_items": [
      {
        "prod_code": "SKU-001",
        "prod_name": "사과 5kg",
        "quantity": 2,
        "unit_price": 15000
      }
    ]
  },
  "meta": {},
  "errors": []
}