구매자 공지 API

연결 판매자 공지 목록 조회 API입니다.

엔드포인트

구분설명

GET /notices

공지 목록 (notices:read)

목록 조회

승인된 연결 판매자의 공지(전체 대상·특정 구매자 대상)를 반환합니다.

bash

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

엔드포인트 예시

GET /notices

공지 목록 (notices:read)

응답 예시 (200)

json

{
  "data": [
    {
      "title": "휴무 안내",
      "message": "6/30 하루 휴무입니다.",
      "seller_code": "123-45-67890",
      "created_at": "2026-06-26T08:00:00Z",
      "source": "seller"
    }
  ],
  "meta": {},
  "errors": []
}

응답 필드

필드	필수여부	자릿수/형식	설명
title	-	string	제목
message	-	string	본문
seller_code	-	string	판매자 사업자번호
created_at	-	string (ISO 8601)	작성 시각
source	-	string \| null	출처(seller 등)

제한 사항

공지 작성·수정은 제공하지 않습니다.
notices:read 스코프와 유료 api_access가 필요합니다.