엔드포인트 목록
인가 서버 · 보호 리소스 · MCP 의 모든 주소를 한곳에 모았습니다.
전체 주소
기본 호스트는 https://api.mallstory.kr 입니다.
| 메서드 | 경로 | 용도 |
|---|---|---|
| GET | /.well-known/oauth-authorization-server | 인가 서버 메타데이터 (RFC 8414) |
| GET | /.well-known/oauth-protected-resource/v1 | 보호 리소스 메타데이터 — REST (RFC 9728) |
| GET | /.well-known/oauth-protected-resource/mcp/{shop_id} | 보호 리소스 메타데이터 — MCP (RFC 9728) |
| POST | /api/oauth/register | 동적 클라이언트 등록 (RFC 7591) — MCP 커넥터 |
| GET | /oauth/authorize | 소유자 동의 화면 (브라우저) — 회원 동의는 쇼핑몰 주소의 같은 경로 |
| POST | /api/oauth/token | 토큰 발급 · 갱신 |
| POST | /api/oauth/revoke | 토큰 폐기 (RFC 7009) |
| POST | /v1/member/login | 회원 로그인 — 아이디 · 비밀번호로 회원 토큰 (서버 앱 · me:*) |
| POST | /mcp | MCP 서버 (Streamable HTTP) — 쇼핑몰은 토큰이 정함 |
| POST | /mcp/{shop_id} | MCP 서버 — 쇼핑몰을 주소에 적는 방식 |
| GET | /.well-known/oauth-protected-resource/mcp | 보호 리소스 메타데이터 — MCP 한 줄 주소 (RFC 9728) |
| GET | /v1/token | 토큰 정보 조회 (권한 필요 없음) |
| GET | /v1/me | 회원 본인 정보 조회 (회원 토큰 · me:read) |
| PATCH | /v1/me | 회원 본인 정보 수정 (회원 토큰 · me:write) |
| GET | /v1/shop/{shop_unique}/members | 회원 목록 (customers:read) |
| GET · POST | /v1/shop/{shop_unique}/levels | 회원 등급 목록 · 생성 (customers:read · write) |
| PATCH · DELETE | /v1/shop/{shop_unique}/levels/{level_unique} | 회원 등급 수정 · 삭제 (customers:write) |
| GET | /v1/shop/{shop_unique}/members/{member_unique} | 회원 상세 (customers:read) |
| PATCH | /v1/shop/{shop_unique}/members/{member_unique} | 회원 수정 (customers:write) |
| GET · POST | /v1/shop/{shop_unique}/members/{member_unique}/points | 회원 적립금 잔액 · 내역 (customers:read) · 지급 · 차감 (customers:write) |
| GET · POST | /v1/shop/{shop_unique}/coupons | 쿠폰 목록 (promotions:read) · 생성 (promotions:write) |
| GET · PATCH · DELETE | /v1/shop/{shop_unique}/coupons/{coupon_unique} | 쿠폰 상세 (promotions:read) · 수정 · 삭제 (promotions:write) |
| GET | /v1/shop/{shop_unique}/coupons/issues | 쿠폰 이용 내역 — 모든 쿠폰 · /coupons/{coupon_unique}/issues 는 쿠폰 하나 (promotions:read) |
| GET · POST | /v1/shop/{shop_unique}/coupons/{coupon_unique}/serials | 발급쿠폰 조회 (promotions:read) · 쿠폰번호 발급 (promotions:write) |
| GET | /v1/shop/{shop_unique}/products | 상품 목록 (products:read) |
| POST | /v1/shop/{shop_unique}/products | 상품 등록 (products:write) |
| GET | /v1/shop/{shop_unique}/products/{product_unique} | 상품 상세 + 옵션 (products:read) |
| PATCH | /v1/shop/{shop_unique}/products/{product_unique} | 상품 수정 (products:write) |
| DELETE | /v1/shop/{shop_unique}/products/{product_unique} | 상품 삭제 (products:write) |
| GET | /v1/shop/{shop_unique}/categories | 상품 카테고리 목록 (products:read) |
| POST | /v1/shop/{shop_unique}/categories | 카테고리 생성 (products:write) |
| PATCH | /v1/shop/{shop_unique}/categories/{category_unique} | 카테고리 수정 (products:write) |
| DELETE | /v1/shop/{shop_unique}/categories/{category_unique} | 카테고리 삭제 (products:write) |
| POST | /v1/shop/{shop_unique}/categories/{category_unique}/move | 카테고리 옮기기 (products:write) |
| GET · POST | /v1/shop/{shop_unique}/badges | 상품 배지 목록 (products:read) · 생성 (products:write) |
| GET · PATCH · DELETE | /v1/shop/{shop_unique}/badges/{badge_unique} | 상품 배지 상세 (products:read) · 수정 · 삭제 (products:write) |
| GET · POST | /v1/shop/{shop_unique}/icons | 상품 아이콘 목록 (products:read) · 생성 (products:write) |
| GET · PATCH · DELETE | /v1/shop/{shop_unique}/icons/{icon_unique} | 상품 아이콘 상세 (products:read) · 수정 · 삭제 (products:write) |
| POST | /v1/shop/{shop_unique}/files/images | 이미지 업로드 → file_id (products:write) |
| GET · POST | /v1/shop/{shop_unique}/templates/{kind} | 템플릿 목록 · 생성 — common · delivery · colors · sizes · reviews (products:read · write) |
| GET · PATCH · DELETE | /v1/shop/{shop_unique}/templates/{kind}/{id} | 템플릿 상세 · 수정 · 삭제 (products:read · write) |
| GET · POST | /v1/shop/{shop_unique}/surcharges | 배송 할증지역 목록 · 등록 (products:read · write) |
| PATCH · DELETE | /v1/shop/{shop_unique}/surcharges/{id} | 할증지역 수정 · 삭제 (products:write) |
| POST | /v1/shop/{shop_unique}/surcharges/bulk | 할증지역 일괄 등록 (products:write) |
| GET · PATCH | /v1/shop/{shop_unique}/surcharges/base | 기본 할증지역 검색 · 이 몰에서 빼기/되돌리기 |
| GET | /v1/shop/{shop_unique}/surcharges/{juso|address|locate|preview|reverse|map} | 할증지역 찾기 · 좌표 · 지도 (products:read) |
| GET | /v1/store/categories | 쇼핑몰 카테고리 — 손님 화면 그대로 (회원 토큰 · X-Client-Id) |
| GET | /v1/store/categories/{slug} | 카테고리 상세 — 상단 · 추천 상품 · 정렬 선택지 · 하위 (회원 토큰 · X-Client-Id) |
| GET | /v1/store/categories/{slug}/products | 카테고리 상품 — 열람자 기준 가격 (회원 토큰 · X-Client-Id) |
| GET | /v1/store/products/{product_no} | 상품 상세 — 열람자 기준 가격 (회원 토큰 · X-Client-Id) |
| GET | /v1/shop/{shop_unique} | 쇼핑몰 정보 조회 (shop:read) |
| PATCH | /v1/shop/{shop_unique} | 쇼핑몰 정보 수정 (shop:write) |
| GET | /v1/shop/{shop_unique}/{resource} | 리소스 (orders · products · members …)준비 중 |