CartItem API

CREMA 서버에 등록된 개별 유저의 장바구니를 확인하고, 등록/수정하는 방법을 제공합니다.

List cart items

유저의 장바구니 목록을 가져옵니다.

with `user_id`

GET /v1/users/:user_id/cart_items HTTP/1.1

이름	타입	필수	설명
`user_id`	integer	✔	회원의 크리마 `id`
`limit`	integer	✖	한 페이지에 가져올 장바구니 개수입니다. 최대 100개까지 가능합니다. 기본: `30`

with `user_code`

GET /v1/cart_items HTTP/1.1

이름	타입	필수	설명
`user_code`	string	✔	회원의 쇼핑몰 아이디
`limit`	integer	✖	한 페이지에 가져올 장바구니 개수입니다. 최대 100개까지 가능합니다. 기본: `30`

Response

HTTP/1.1 200 OK
Link: <https://api.cre.ma/v1/users/1/cart_items?page=372>; rel="last", <https://api.cre.ma/v1/users/1/cart_items&page=2>; rel="next"

[
  {
    "id": 1,
    "user_id": 1,
    "product_id": 6080,
    "code": "fce90b06082e5d4ce91016d1311b9c52",
    "added_to_cart_at": "2015-11-05T00:53:00.000+09:00",
    "created_at": "2015-11-10T22:42:40.000+09:00",
    "updated_at": "2015-11-10T22:42:40.000+09:00"
  },
  {
    "id": 2,
    "user_id": 1,
    "product_id": 6030,
    "code": "eb46d86d28b7036e10fef99e21b61698",
    "added_to_cart_at": "2015-11-05T00:57:00.000+09:00",
    "created_at": "2015-11-10T22:42:40.000+09:00",
    "updated_at": "2015-11-10T22:42:40.000+09:00"
  },
  {
    "id": 3,
    "user_id": 1,
    "product_id": 6030,
    "code": "fef50bf2acb3d00dba1bb602ded99c15",
    "added_to_cart_at": "2015-11-05T00:58:00.000+09:00",
    "created_at": "2015-11-10T22:42:40.000+09:00",
    "updated_at": "2015-11-10T22:42:40.000+09:00"
  }
]

Get a single cart item

장바구니 항목 하나의 상세 정보를 가져옵니다.

with `user_id` and `id`

GET /v1/users/:user_id/cart_items/:id HTTP/1.1

이름	타입	필수	설명
`user_id`	integer	✔	회원의 크리마 `id`
`id`	integer	✔	장바구니 항목의 `id`

with `user_code` and `id`

GET /v1/cart_items/:id HTTP/1.1

이름	타입	필수	설명
`id`	integer	✔	가져올 장바구니 항목 `id`
`user_code`	string	✔	회원의 쇼핑몰 아이디

with `user_id` and `code`

GET /v1/users/:user_id/cart_items HTTP/1.1

이름	타입	필수	설명
`user_id`	integer	✔	회원의 크리마 `id`
`code`	string	✔	쇼핑몰에서 사용되고 있는 장바구니 항목의 고유 ID

with `user_code` and `code`

GET /v1/cart_items HTTP/1.1

이름	타입	필수	설명
`user_code`	string	✔	회원의 쇼핑몰 아이디
`code`	string	✔	쇼핑몰에서 사용되고 있는 장바구니 항목의 고유 ID

Response

HTTP/1.1 200 OK

{
  "id": 1,
  "user_id": 1,
  "product_id": 6080,
  "code": "fce90b06082e5d4ce91016d1311b9c52",
  "added_to_cart_at": "2015-11-05T00:53:00.000+09:00",
  "created_at": "2015-11-10T22:42:40.000+09:00",
  "updated_at": "2015-11-10T22:42:40.000+09:00"
}

Create or Update a cart item

새로운 장바구니 항목을 생성하거나 기존 데이터를 수정합니다.

with `user_id`

POST /v1/users/:user_id/cart_items HTTP/1.1

이름	타입	필수	설명
`user_id`	integer	✔	회원의 크리마 `id`
`product_id`	integer	✔	장바구니가 속한 상품의 크리마 서비스측 `id`(쇼핑몰 서비스측 ID 아님) `product_code`를 입력한 경우 `product_id`는 입력하지 않아도 됩니다.
`product_code`	string	✔	장바구니가 속한 상품의 쇼핑몰 서비스측 고유 식별자. `product_id`를 입력한 경우 `product_code`는 입력하지 않아도 됩니다.
`code`	string	✔	쇼핑몰에서 사용되고 있는 장바구니 항목의 고유 ID
`added_to_cart_at`	datetime(ISO 8601)	✔	회원이 장바구니에 추가한 시각. 초단위까지만 유효

with `user_code`

POST /v1/cart_items HTTP/1.1

이름	타입	필수	설명
`user_code`	string	✔	회원의 쇼핑몰 아이디
`product_id`	string	✔	장바구니가 속한 상품의 크리마 서비스측 `id`(쇼핑몰 서비스측 ID 아님) `product_code`를 입력한 경우 `product_id`는 입력하지 않아도 됩니다.
`product_code`	integer	✔	장바구니가 속한 상품의 쇼핑몰 서비스측 고유 식별자. `product_id`를 입력한 경우 `product_code`는 입력하지 않아도 됩니다.
`code`	string	✔	쇼핑몰에서 사용되고 있는 장바구니 항목의 고유 ID
`added_to_cart_at`	datetime(ISO 8601)	✔	회원이 장바구니에 추가한 시각. 초단위까지만 유효

Response

HTTP/1.1 201 Created
Location: https://api.cre.ma/v1/users/1/cart_items

{
  "id": 5,
  "user_id": 1,
  "product_id": 6081,
  "code": "fce90b06082e5d4ce91016d1311b9c52",
  "added_to_cart_at": "2015-11-05T00:53:00.000+09:00",
  "created_at": "2015-11-10T22:42:40.000+09:00",
  "updated_at": "2015-11-10T22:42:40.000+09:00"
}

Update a cart item

장바구니 항목의 정보를 수정합니다.

with `user_id` and `id`

PATCH /v1/users/:user_id/cart_items/:id HTTP/1.1

이름	타입	필수	설명
`user_id`	integer	✔	회원의 크리마 `id`
`id`	integer	✔	장바구니 항목의 `id`
`product_id`	string	✖	장바구니가 속한 상품의 크리마 서비스측 `id`(쇼핑몰 서비스측 ID 아님) `product_code`를 입력한 경우 `product_id`는 입력하지 않아도 됩니다.
`product_code`	integer	✖	장바구니가 속한 상품의 쇼핑몰 서비스측 고유 식별자. `product_id`를 입력한 경우 `product_code`는 입력하지 않아도 됩니다.
`code`	string	✖	쇼핑몰에서 사용되고 있는 장바구니 항목의 고유 ID
`added_to_cart_at`	datetime(ISO 8601)	✖	회원이 장바구니에 추가한 시각. 초단위까지만 유효

with `user_code` and `id`

PATCH /v1/cart_items/:id HTTP/1.1

이름	타입	필수	설명
`id`	integer	✔	장바구니 항목의 `id`
`user_code`	string	✔	회원의 쇼핑몰 아이디
`product_id`	string	✖	장바구니가 속한 상품의 크리마 서비스측 `id`(쇼핑몰 서비스측 ID 아님) `product_code`를 입력한 경우 `product_id`는 입력하지 않아도 됩니다.
`product_code`	integer	✖	장바구니가 속한 상품의 쇼핑몰 서비스측 고유 식별자. `product_id`를 입력한 경우 `product_code`는 입력하지 않아도 됩니다.
`code`	string	✖	쇼핑몰에서 사용되고 있는 장바구니 항목의 고유 ID
`added_to_cart_at`	datetime(ISO 8601)	✖	회원이 장바구니에 추가한 시각. 초단위까지만 유효

with `user_id` and `code`

PATCH /v1/users/:user_id/cart_items HTTP/1.1

이름	타입	필수	설명
`user_id`	integer	✔	회원의 크리마 id
`product_id`	string	✖	장바구니가 속한 상품의 크리마 서비스측 `id`(쇼핑몰 서비스측 ID 아님) `product_code`를 입력한 경우 `product_id`는 입력하지 않아도 됩니다.
`product_code`	integer	✖	장바구니가 속한 상품의 쇼핑몰 서비스측 고유 식별자. `product_id`를 입력한 경우 `product_code`는 입력하지 않아도 됩니다.
`code`	string	✔	쇼핑몰에서 사용되고 있는 장바구니 항목의 고유 ID
`added_to_cart_at`	datetime(ISO 8601)	✖	회원이 장바구니에 추가한 시각. 초단위까지만 유효

with `user_code` and `code`

PATCH /v1/cart_items HTTP/1.1

이름	타입	필수	설명
`user_code`	string	✔	회원의 쇼핑몰 아이디
`product_id`	string	✖	장바구니가 속한 상품의 크리마 서비스측 `id`(쇼핑몰 서비스측 ID 아님) `product_code`를 입력한 경우 `product_id`는 입력하지 않아도 됩니다.
`product_code`	integer	✖	장바구니가 속한 상품의 쇼핑몰 서비스측 고유 식별자. `product_id`를 입력한 경우 `product_code`는 입력하지 않아도 됩니다.
`code`	string	✔	쇼핑몰에서 사용되고 있는 장바구니 항목의 고유 ID
`added_to_cart_at`	datetime(ISO 8601)	✖	회원이 장바구니에 추가한 시각. 초단위까지만 유효

Response

HTTP/1.1 204 No Content
Location: https://api.cre.ma/v1/users/:user_id/cart_items/:id

Delete a single cart item

장바구니 항목 하나를 삭제합니다.

with `user_id` and `id`

DELETE /v1/users/:user_id/cart_items/:id HTTP/1.1

이름	타입	필수	설명
`user_id`	integer	✔	회원의 크리마 `id`
`id`	integer	✔	장바구니 항목의 `id`

with `user_code` and `id`

DELETE /v1/cart_items/:id HTTP/1.1

이름	타입	필수	설명
`id`	integer	✔	장바구니 항목의 `id`
`user_code`	string	✔	회원의 쇼핑몰 아이디

with `user_id` and `code`

DELETE /v1/users/:user_id/cart_items HTTP/1.1

이름	타입	필수	설명
`user_id`	integer	✔	회원의 크리마 `id`
`code`	string	✔	쇼핑몰에서 사용되고 있는 장바구니 항목의 고유 ID

with `user_code` and `code`

DELETE /v1/cart_items HTTP/1.1

이름	타입	필수	설명
`user_code`	string	✔	회원의 쇼핑몰 아이디
`code`	string	✔	쇼핑몰에서 사용되고 있는 장바구니 항목의 고유 ID

Response

HTTP/1.1 204 No Content

직접 사용해 보세요!

API Explorer를 사용하여 API 요청 및 응답을 확인해 보세요.

장바구니 목록
장바구니 정보
장바구니 생성
장바구니 업데이트
장바구니 삭제

CartItem API

List cart items

with user_id

with user_code

Response

Get a single cart item

with user_id and id

with user_code and id

with user_id and code

with user_code and code

Response

Create or Update a cart item

with user_id

with user_code

Response

Update a cart item

with user_id and id

with user_code and id

with user_id and code

with user_code and code

Response

Delete a single cart item

with user_id and id

with user_code and id

with user_id and code

with user_code and code

Response

직접 사용해 보세요!

결과

with `user_id`

with `user_code`

with `user_id` and `id`

with `user_code` and `id`

with `user_id` and `code`

with `user_code` and `code`

with `user_id`

with `user_code`

with `user_id` and `id`

with `user_code` and `id`

with `user_id` and `code`

with `user_code` and `code`

with `user_id` and `id`

with `user_code` and `id`

with `user_id` and `code`

with `user_code` and `code`