구매자 API 개요
일반 구매자(buyer) 전용 조회 API·MCP입니다. 전용/테스트 구매자와 쓰기는 지원하지 않습니다.
대상
users.user_type이 buyer인 일반 구매자만 이용할 수 있습니다. force_buyer(전용구매자)·테스트 계정은 API Key 발급·MCP 승인·호출이 거부됩니다.
이용 조건
구분설명
플랜
본인 유료 구독 + api_access(판매자와 동일 게이트).
REST 인증
Bearer qnc_buyer_* (대시보드 > API 연동설정 > API 키발급).
MCP 인증
OAuth Device Flow, role=buyer. stdio는 QNECTOR_MCP_ROLE=buyer.
1차 범위
조회(read)만 — 주문/견적 생성·결제·연결 요청은 미포함.
제공 표면
- REST Base: https://qnector.kr/api/v1/buyer
- 연결 판매자 · 품목 · 주문 · 견적 · 정산 · 공지 · 문의 (모두 GET/read)
- MCP: /api/mcp/v1/buyer/* · 도구 접두어 qnector_buyer_*
- 상세 문서는 좌측 「구매자 API」 메뉴의 리소스별 페이지를 참고하세요.
식별자
공개 응답은 UUID를 노출하지 않습니다. 판매자는 seller_code(사업자번호), 주문/견적은 order_number·quote_number, 품목은 prod_code를 사용합니다. 멀티 판매자 환경에서는 seller_code 필터를 권장합니다.