Auth
POST
/v1/auth/register
이메일/비밀번호 회원가입 후 인증 메일을 발송합니다.
Header
Content-Type: application/json
Body
{
"email": "",
"password": "",
"name": "",
}
Response
▶ 버튼을 눌러 API를 테스트하세요
POST
/v1/auth/login
이메일/비밀번호 로그인 후 access token을 반환하고 refresh cookie를 설정합니다.
Header
Content-Type: application/json
Body
{
"email": "",
"password": "",
}
Response
▶ 버튼을 눌러 API를 테스트하세요
POST
/v1/auth/refresh
Refresh cookie를 회전시키며 새 access token을 발급합니다. 요청 본문 없이 쿠키만으로 동작합니다.
Header
Content-Type: application/json
Body
{
}
Response
▶ 버튼을 눌러 API를 테스트하세요
Garment
GET
/v1/garment/
의류 목록을 페이지네이션으로 조회합니다. category, search, page, size 쿼리 파라미터를 지원합니다.
Header
Authorization: Bearer {access_token}
Body
{
}
Response
▶ 버튼을 눌러 API를 테스트하세요
POST
/v1/garment/
새 의류를 등록합니다. vendor 이상 권한이 필요합니다.
Header
Authorization: Bearer {access_token}Content-Type: application/json
Body
{
"name": "",
"category": "",
"description": "",
"material": "",
"price": ,
}
Response
▶ 버튼을 눌러 API를 테스트하세요
POST
/v1/garment/{garment_id}/images
의류 이미지를 업로드합니다. front/back 유형별 이미지를 multipart로 전송합니다.
Header
Authorization: Bearer {access_token}Content-Type: multipart/form-data
Body
| Key | Value | Description |
|---|---|---|
| files | (의류 이미지) | |
| image_type | (front 또는 back) |
Response
▶ 버튼을 눌러 API를 테스트하세요
POST
/v1/garment/{garment_id}/generate-3d
의류 3D 모델 생성을 요청합니다. 비동기 파이프라인으로 처리되며, status_url로 진행 상황을 폴링할 수 있습니다.
Header
Authorization: Bearer {access_token}Content-Type: application/json
Body
{
"include_measurements": ,
"target_fit_types": [
"",
]
}
Response
▶ 버튼을 눌러 API를 테스트하세요
SDK Config
POST
/v1/sdk/configs
SDK 설정을 생성하고 API 키를 1회 반환합니다. vendor 이상 권한이 필요합니다.
Header
Authorization: Bearer {access_token}Content-Type: application/json
Body
{
"client_name": "",
"permissions": [
"",,
"",
]
"rate_limit": ,
"allowed_origins": [
"",
]
}
Response
▶ 버튼을 눌러 API를 테스트하세요
GET
/v1/sdk/configs
SDK 설정 목록을 조회합니다. vendor는 자기 브랜드만, manager/admin은 전체를 조회합니다.
Header
Authorization: Bearer {access_token}
Body
{
}
Response
▶ 버튼을 눌러 API를 테스트하세요
GET
/v1/sdk/configs/{config_id}
SDK 설정 단건을 조회합니다. vendor는 자기 브랜드의 설정만 조회 가능합니다.
Header
Authorization: Bearer {access_token}
Body
{
}
Response
▶ 버튼을 눌러 API를 테스트하세요
POST
/v1/sdk/configs/{config_id}/regenerate-key
API 키를 재생성합니다. 기존 키는 즉시 무효화됩니다.
Header
Authorization: Bearer {access_token}
Body
{
}
Response
▶ 버튼을 눌러 API를 테스트하세요
DELETE
/v1/sdk/configs/{config_id}
SDK 설정을 비활성화합니다 (소프트 삭제). 해당 API 키는 더 이상 사용할 수 없습니다.
Header
Authorization: Bearer {access_token}
Body
{
}
Response
▶ 버튼을 눌러 API를 테스트하세요
Brand
GET
/v1/brands
등록된 브랜드 목록을 조회합니다. 인증 없이 접근 가능합니다. search, page, per_page 쿼리 파라미터를 지원합니다.
Header
Body
{
}
Response
▶ 버튼을 눌러 API를 테스트하세요