Mall StoryDevelopers
Mall Story
관리자 API상품 관리소유자 토큰

상품 목록

상품 목록을 검색어 · 카테고리 · 판매 상태 · 진열 여부로 걸러 읽습니다.

업데이트됨 10.13 — 목록 정렬 sort · order 를 받습니다

요청

GEThttps://api.mallstory.kr/v1/shop/{shop_unique}/products
쿼리형식설명
pagenumber쪽 번호(1부터, 기본 1)
sizenumber쪽당 건수(기본 20, 최대 100)
keywordstring상품명 · 관리 코드 검색
category_idstring이 카테고리에 걸린 상품(하위 카테고리는 포함하지 않음)
statusstring판매 상태(status_type 값 하나) 코드값
displayedbooleantrue 전시 중인 것만 · false 전시하지 않는 것만
sortstring정렬 키. 관리자 상품 목록의 정렬과 같습니다. 빼면 product_no 내림차순(최신 등록순) 코드값
orderstring정렬 방향. 빼면 desc. sort 와 함께 보냅니다 — 혼자 보내면 400 코드값
bash요청
curl 'https://api.mallstory.kr/v1/shop/{shop_unique}/products?keyword=린넨 셔츠&size=1' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...'

응답

json200 OK (줄임)
{
  "items": [
    {
      "product_unique": "6accaa68c2ca90eedea62100",
      "product_no": 50,
      "name": "린넨 셔츠",
      "promotion_text": "봄 신상 10% 할인",
      "status_type": "SALE",
      "sale_price": 39000,
      "list_price": 49000,
      "stock_quantity": 15,
      "stock_unlimited": false,
      "tax_type": "TAX",
      "display_status": "DISPLAY",
      "category_id": "6aab6a9ddd8941ed187ffe4b",
      "images": [],
      "option_count": 3,
      "created": "2026-10-12T09:37:44.797Z",
      "updated": "2026-10-12T09:37:44.797Z",
      "…": "상세의 product 와 같은 필드(원가 cost_price 제외)"
    }
  ],
  "page": 1,
  "size": 1,
  "total": 1,
  "has_more": false
}
필드형식설명
itemsarray상품 줄. 필드는 상품 상세의 product 와 같고 원가(cost_price)만 없습니다
items[].option_countnumber옵션 행 수(목록에만). 0 이 아니면 재고는 옵션에서 고칩니다
pagenumber지금 쪽 번호
sizenumber쪽당 건수
totalnumber조건에 맞는 전체 건수
has_moreboolean다음 쪽이 있는가

오류

상태code언제
400InvalidParameterValuedisplayed 가 true · false 가 아님
401MissingLoginSessionAuthorization 헤더에 Bearer 토큰이 없음
401InvalidAccessToken토큰이 틀리거나 만료 · 폐기됨
403InsufficientScope토큰에 products:read · products:write 가 없음