구매자 견적 API

내가 작성·수신한 견적 목록·상세 조회 API입니다.

엔드포인트

구분설명

GET /quotes

견적 목록 (quotes:read)

GET /quotes/{quote_number}

견적 상세 (quotes:read)

목록 조회

쿼리: scope(all | authored | received, 기본 all), page, limit(1~100, 기본 20)

authored는 구매자가 작성한 견적, received는 판매자가 보낸 수신함 복사본입니다.

bash

curl "https://qnector.kr/api/v1/buyer/quotes?scope=all&page=1&limit=20" \
  -H "Authorization: Bearer qnc_buyer_YOUR_API_KEY"

엔드포인트 예시

GET /quotes

견적 목록 (quotes:read)

응답 예시 (200)

json

{
  "data": [
    {
      "quote_number": "QT-20260626-001",
      "status": "sent",
      "creator_role": "buyer",
      "total_amount": 30000,
      "valid_until": "2026-07-26",
      "created_at": "2026-06-26T09:00:00Z",
      "memo": null,
      "items": [
        {
          "prod_code": "SKU-001",
          "prod_name": "사과 5kg",
          "quantity": 2,
          "unit_price": 15000
        }
      ]
    }
  ],
  "meta": { "page": 1, "limit": 20 },
  "errors": []
}

상세 조회

경로의 quote_number로 조회합니다. UUID 경로는 404입니다.