FitProduct API

CREMA 서버에 등록된 핏 상품 정보를 확인하고, 등록/수정하는 방법을 제공합니다.

List fit products

핏 상품 목록을 가져옵니다.

GET /v1/fit/products HTTP/1.1

Parameters

이름 타입 필수 설명
limit integer ✖ 한 페이지의 상품 목록 길이. 범위: 1 ~ 100. 기본: 30
page integer ✖ 페이지 번호입니다. 최대 페이지 수는 Link http header의 rel="last"에 기재되어 있습니다. 기본: 1

Response

HTTP/1.1 200 OK

[
  {
    "id": 1,
    "name": "레더라이더재킷",
    "code": "2009432",
    "created_at": "2018-02-20T20:10:56.000+09:00",
    "update_at": "2018-04-06T15:30:37.000+09:00"
  },
  {
    "id": 2,
    "name": "사파이어스커트",
    "code": "2008342",
    "created_at": "2018-02-20T01:19:40.000+09:00",
    "update_at": "2018-04-06T15:30:37.000+09:00"
  }
]

Get a single fit product

핏 상품 한 개의 상세 정보를 가져옵니다.

with id

GET /v1/fit/products/:id HTTP/1.1
이름 타입 필수 설명
id integer ✔ 핏 상품의 id

with code

GET /v1/fit/products HTTP/1.1
이름 타입 필수 설명
code string ✔ 상품의 code

Response

{
  "id": 1,
  "code": "2008342",
  "name": "사파이어스커트",
  "size_name": "사이즈",
  "sizes": {
    "S": {
      "총장": {
        "value": 49.0,
        "description": ""
      },
      "허리단면": {
        "value": 36.5,
        "description": "(조절가능)"
      },
      "힙": {
        "value": 45.0,
        "description": ""
      },
      "밑단": {
        "value": 67.0,
        "description": ""
      }
    },
    "M": {
      "총장": {
        "value": 51.0,
        "description": ""
      },
      "허리단면": {
        "value": 37.5,
        "description": "(조절가능)"
      },
      "힙": {
        "value": 46.0,
        "description": ""
      },
      "밑단": {
        "value": 68.0,
        "description": ""
      }
    }
  },
  "infos": {
    "색상": "소라, 블랙",
    "사이즈": "S,M",
    "소재": "폴리 100",
    "TIP": "모든 의류의 첫 세탁은 손세탁이나 드라이크리닝을 권장 합니다."
  },
  "properties": {
    "안감": ["있음"],
    "비침": ["없음"],
    "두께감": ["두꺼움"],
    "신축성": ["약간"]
  }
}

Create or Update a fit product

새로운 핏 상품을 생성하거나 기존 데이터를 수정합니다.
Product 와 Category 가 먼저 생성되어 있어야 합니다.

POST /v1/fit/products HTTP/1.1

Parameters

이름 타입 필수 설명
code string ✔ 상품 code. 상품의 고유 식별자입니다. 다른 상품과 중복되면 안됩니다.
size_option_name string ✖ 상품 판매 옵션 중, 사이즈 입력 기준이 되는 옵션을 설정합니다.
sizes string ✖ 상품의 실측 사이즈 데이터를 JSON 형식으로 입력합니다.
예시
{"S":{"총장":{"value":95.5,"description":""}},"M":{"총장":{"value":96.5,"description":""}}}
infos string ✖ 상품의 정보를 JSON 형식으로 입력합니다.(value는 각각 최대 255자까지 등록 가능합니다.)
예시
{"소재":"면 100 %","색상":"블랙"}
properties string ✖ 상품의 속성을 JSON 형식으로 입력합니다.
예시
{"신축성":["좋음"],"비침":["없음"]}

Response

HTTP/1.1 201 Created
Location: http://api.cre.ma/v1/fit/products/1

{
  "id": 1,
  "code": 1,
  "name": "플레어 티: 부담없이 편하게 입기 좋은 티셔츠",
  "size_option_name": "사이즈",
  "sizes": {
    "S": {
      "총장": {
        "value": 95.5,
        "description": ""
      }
    },
    "M": {
      "총장": {
        "value": 96.5,
        "description": ""
      }
    }
  },
  "infos": {
    "소재": "면 100%",
    "색상": "블랙"
  },
  "properties": {
    "신축성": ["좋음"],
    "비침": ["없음"]
  }
}

Update a fit product

핏 상품의 내용을 수정합니다.

with id

PATCH /v1/fit/products/:id HTTP/1.1
이름 타입 필수 설명
id integer ✔ 핏 상품의 id
size_option_name string ✖ 상품 판매 옵션 중, 사이즈 입력 기준이 되는 옵션을 설정합니다.
sizes string ✖ 상품의 실측 사이즈 데이터를 JSON 형식으로 입력합니다.
예시
{"S":{"총장":{"value":95.5,"description":""}},"M":{"총장":{"value":96.5,"description":""}}}
infos string ✖ 상품의 정보를 JSON 형식으로 입력합니다.(value는 각각 최대 255자까지 등록 가능합니다.)
예시
{"소재":"면 100 %","색상":"블랙"}
properties string ✖ 상품의 속성을 JSON 형식으로 입력합니다.
예시
{"신축성":["좋음"],"비침":["없음"]}

with code

PATCH /v1/fit/products HTTP/1.1
이름 타입 필수 설명
code string ✔ 상품의 code
size_option_name string ✖ 상품 판매 옵션 중, 사이즈 입력 기준이 되는 옵션을 설정합니다.
sizes string ✖ 상품의 실측 사이즈 데이터를 JSON 형식으로 입력합니다.
예시
{"S":{"총장":{"value":95.5,"description":""}},"M":{"총장":{"value":96.5,"description":""}}}
infos string ✖ 상품의 정보를 JSON 형식으로 입력합니다.(value는 각각 최대 255자까지 등록 가능합니다.)
예시
{"소재":"면 100 %","색상":"블랙"}
properties string ✖ 상품의 속성을 JSON 형식으로 입력합니다.
예시
{"신축성":["좋음"],"비침":["없음"]}

Response

HTTP/1.1 204 No Content
Location: https://api.cre.ma/v1/fit/products/:id

Delete a single fit product

핏 상품 한 개를 삭제합니다.

with id

DELETE /v1/fit/products/:id HTTP/1.1
이름 타입 필수 설명
id integer ✔ 핏 상품의 id

with code

DELETE /v1/fit/products HTTP/1.1
이름 타입 필수 설명
code string ✔ 상품의 code

Response

HTTP/1.1 204 No Content