Mall StoryDevelopers
Mall Story
관리자 API템플릿 관리소유자 토큰

사이즈

옵션 사이즈를 고르는 사이즈 템플릿을 관리합니다.

무엇인가요

옵션 사이즈를 고르는 사이즈 템플릿입니다(의류 · 신발 …).

항목내용
권한읽기 products:read · 쓰기 products:write (소유자 토큰)
상품에서 쓰는 곳상품의 size_template_id · sizes
관리자 화면상품 > 템플릿 관리 — 같은 검증 · 같은 저장
요청경로바로가기
GEThttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes목록
GEThttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes/{size_template_unique}상세
POSThttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes생성
PATCHhttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes/{size_template_unique}수정
DELETEhttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes/{size_template_unique}삭제

목록

GEThttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes

이 쇼핑몰의 템플릿 전부입니다(쪽 나눔 없음). 줄마다 이 템플릿을 쓰는 상품 수 used_count 가 붙습니다 — 관리자 목록의 "적용상품" 칸과 같습니다.

쿼리형식설명
sortstring정렬 키. 빼면 등록일시 최신순(관리자 목록의 기본과 같음) 코드값
orderstring정렬 방향. 빼면 name 는 오름차순, 시각은 최신순. sort 와 함께 보냅니다 코드값
bash요청
curl 'https://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...'
json200 OK
{
  "items": [
    {
      "size_template_unique": "6acca48fc2ca90eedea620fb",
      "name": "상의 (S~XL)",
      "sizes": [
        "S",
        "M",
        "L",
        "XL"
      ],
      "created": "2026-10-12T09:12:47.549Z",
      "updated": "2026-10-12T09:12:47.549Z",
      "used_count": 0
    }
  ]
}

상세

GEThttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes/{size_template_unique}
bash요청
curl 'https://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes/6acca48fc2ca90eedea620fb' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...'
json200 OK
{
  "size_template_unique": "6acca48fc2ca90eedea620fb",
  "name": "상의 (S~XL)",
  "sizes": [
    "S",
    "M",
    "L",
    "XL"
  ],
  "created": "2026-10-12T09:12:47.549Z",
  "updated": "2026-10-12T09:12:47.549Z",
  "used_count": 0
}

응답 필드

필드형식설명
size_template_uniquestring키. 상세 · 수정 · 삭제 경로에 넣습니다
namestring템플릿명
sizesstring[]사이즈 목록(차례대로)
createdISO생성 시각
updatedISO마지막 수정 시각
used_countnumber이 템플릿을 쓰는 상품 수(목록에만)

생성

POSThttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes

요청 본문

필드형식설명
name필수string템플릿명
sizes필수string[]사이즈 목록(차례대로)
bash요청
curl -X POST 'https://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...' \
  -H 'Content-Type: application/json' \
  -d '{"name":"상의 (S~XL)","sizes":["S","M","L","XL"]}'
json201 Created
{
  "size_template_unique": "6acca48fc2ca90eedea620fb"
}

새 템플릿의 키를 돌려줍니다.

수정

PATCHhttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes/{size_template_unique}

보낸 필드만 바뀝니다. 나머지는 지금 값 그대로입니다. 필드는 생성과 같습니다.

bash요청
curl -X PATCH 'https://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes/6acca48fc2ca90eedea620fb' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...' \
  -H 'Content-Type: application/json' \
  -d '{"sizes":["XS","S","M","L","XL"]}'
json200 OK
{
  "ok": true
}
json수정 뒤 상세
{
  "size_template_unique": "6acca48fc2ca90eedea620fb",
  "name": "상의 (S~XL)",
  "sizes": [
    "XS",
    "S",
    "M",
    "L",
    "XL"
  ],
  "created": "2026-10-12T09:12:47.549Z",
  "updated": "2026-10-12T09:12:47.609Z",
  "used_count": 0
}

삭제

DELETEhttps://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes/{size_template_unique}
bash요청
curl -X DELETE 'https://api.mallstory.kr/v1/shop/{shop_unique}/templates/sizes/6acca48fc2ca90eedea620fb' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...'
json200 OK
{
  "ok": true
}

지운 템플릿으로 옵션을 만든 상품은 템플릿 연결만 풀립니다(옵션은 남음). 응답은 {ok: true} 입니다.

오류

상태code언제
400InvalidParameterValue템플릿명 · 사이즈가 없거나 올바르지 않음(예: 템플릿명을 입력하세요)
404ProductSizeTemplateNotExist없는 키이거나 지운 템플릿
401MissingLoginSessionAuthorization 헤더에 Bearer 토큰이 없음
401InvalidAccessToken토큰이 틀리거나 만료 · 폐기됨
403InsufficientScope토큰에 products:read · products:write 가 없음

오류 본문은 {code, message, request_id} 이고, message 는 관리자 화면과 같은 문구라 사용자에게 그대로 보여 줄 수 있습니다.