연결 판매자 API

일반 구매자가 연결한 판매자 목록을 조회하는 API입니다.

엔드포인트

구분설명

GET /sellers

연결 판매자 목록 (sellers:read)

목록 조회

현재 구매자와 관계가 있는 판매자만 반환합니다. 검색(q) 파라미터 없이 호출하면 관계 목록(승인·대기·거절 포함)을 조회합니다.

식별자는 seller_code(사업자번호)입니다. 내부 UUID는 응답에 포함되지 않습니다.

bash

curl "https://qnector.kr/api/v1/buyer/sellers" \
  -H "Authorization: Bearer qnc_buyer_YOUR_API_KEY"

엔드포인트 예시

GET /sellers

연결 판매자 목록 (sellers:read)

응답 예시 (200)

json

{
  "data": [
    {
      "seller_code": "123-45-67890",
      "company_name": "샘플 판매자",
      "ceo_name": "홍길동",
      "status": "approved",
      "email": "seller@example.com",
      "phone": "02-1234-5678",
      "business_type": "도매",
      "business_item": "식료품"
    }
  ],
  "meta": {},
  "errors": []
}

응답 필드

필드	필수여부	자릿수/형식	설명
seller_code	-	string	판매자 사업자번호. 다른 Buyer API의 seller_code 필터와 동일
company_name	-	string	상호
ceo_name	-	string	대표자명
status	-	string	연결 상태. approved \| pending \| rejected \| none
email	-	string	판매자 계정 이메일
phone	-	string	연락처
business_type	-	string	업태
business_item	-	string	종목

연결 상태

구분설명

approved

승인됨 — 품목·주문 등 거래 가능

pending

승인 대기

rejected

거절됨

none

관계 상태 없음(예외)

제한 사항

쓰기(연결 요청·상태 변경)는 1차 범위에서 제공하지 않습니다.
전용구매자·테스트 계정은 호출할 수 없습니다.
유료 플랜(api_access)과 sellers:read 스코프가 필요합니다.