API 개요

개요

큐넥터 API는 B2B 판매자·일반 구매자가 ERP·자동화 도구와 연동할 때 사용합니다. 판매자는 /api/v1/seller, 구매자는 /api/v1/buyer 조회 API와 MCP를 제공합니다.

Cursor·Claude 등 AI 클라이언트에서는 MCP로 동일 데이터를 자연어 조회할 수 있습니다. 구매자 MCP는 role=buyer로 연결합니다.

이용 조건

연동 구조

Pull: 외부 시스템이 API Key로 /api/v1/seller/* 또는 /api/v1/buyer/* REST API를 호출합니다.

Push: 주문·문의 등 알림 이벤트를 등록한 Webhook URL로 전송합니다. 자체 서버 연동 시 연결 테스트(webhook_test)로 수신을 확인할 수 있습니다.

MCP: AI IDE가 OAuth Device Flow로 연결한 뒤 도구(tool)로 데이터를 조회·요약합니다. 판매자·구매자(role)별 도구 세트가 다릅니다.

• API Key는 Bearer 토큰으로만 인증합니다.
• MCP 일반 사용자는 OAuth만 사용합니다(CI·헤드리스만 API 키 대안).
• 다른 판매자의 데이터 접근 시 404를 반환합니다.

Base URL

리소스 식별

외부 API는 판매자가 쓰는 비즈니스 코드·명칭으로 품목·창고를 식별합니다. 호출·응답 모두 동일한 필드를 사용합니다.

• 품목 상세·수정: GET/PUT /products/{prod_code} (URL 인코딩 필요 시 encodeURIComponent 사용)
• 주문 상세·상태: GET/PATCH /orders/{order_number}
• 견적 상세: GET /quotes/{quote_number}
• 창고 수정: PATCH body에 warehouse_code로 대상 지정