콘텐츠로 건너뛰기
/
장바구니 ID로 장바구니 아이템 삭제하기

Catalog API (2.0.0)

Overview

  • Version: 2.0.0
  • Servers: https://store.xsolla.com/api
  • Contact Us by Email
  • Contact URL: https://xsolla.com/
  • Required TLS version: 1.2

Catalog API는 인게임 스토어 카탈로그를 관리하고 구매를 처리하기 위한 엔드포인트를 제공합니다. 엔드포인트를 사용하여 가상 아이템, 인게임 재화, 게임 키, 번들, 장바구니 및 결제 플로우, 아이템 속성을 구성하고 외부 소스에서 아이템을 가져올 수 있습니다.

OpenAPI 설명 다운로드
index.json
index.yaml
언어
서버
Mock server
https://xsolla.redocly.app/_mock/ko/api/catalog/
https://store.xsolla.com/api/

관리자

작업

카탈로그

작업

가상 결제

작업

카탈로그

작업

권한

작업

관리자

작업

관리자

작업

카탈로그

작업

장바구니(클라이언트 측)

작업

아이템으로 특정 장바구니 채우기Client-side

요청

특정 장바구니를 아이템으로 채웁니다. 장바구니에 동일한 SKU를 가진 아이템이 이미 있으면 기존 아이템의 위치가 전달된 값으로 교체됩니다.

보안
AuthForCart
경로
project_idinteger필수

프로젝트 ID입니다. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.

예제: 44056
cart_idstring필수

장바구니 ID입니다.

예제: custom_id
본문application/json
itemsArray of objects필수

아이템 목록입니다.

예제: [{"quantity":123,"sku":"com.xsolla.booster_mega_1"}]
items[].​quantitynumber필수
기본값 123
items[].​skustring필수
기본값 "booster_mega_1"
curl -i -X PUT \
  https://xsolla.redocly.app/_mock/ko/api/catalog/v2/project/44056/cart/custom_id/fill \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "items": [
      {
        "quantity": 123,
        "sku": "com.xsolla.booster_mega_1"
      }
    ]
  }'

응답

아이템이 있는 장바구니를 성공적으로 반환했습니다.

본문application/json
cart_idstring

장바구니 ID입니다.

예제: "cart_id"
is_freeboolean(value-cart_is_free)

true이면 장바구니는 무료입니다.

기본값 false
예제: false
itemsArray of objects
priceobject or null

장바구니 가격입니다.

예제: {"amount":"6150.0000000000000000","amount_without_discount":"6150.0000000000000000","currency":"USD"}
promotionsArray of objects(Catalog_cart_promotions)

전체 장바구니에 적용된 프로모션. 다음의 경우 배열이 반환됩니다.

  • 구매 시 할인 설정 프로모션 코드와 같이 프로모션이 전체 장바구니 금액에 영향을 미치는 경우

  • 장바구니에 보너스 아이템을 추가하는 프로모션의 경우

적용되는 주문 수준 프로모션이 없는 경우 빈 배열이 반환됩니다.

warningsArray of objects
응답
application/json
{
  "cart_id": "cart_id",
  "is_free": false,
  "items": [
    { … }
  ],
  "price": {
    "amount": "6150.0000000000000000",
    "amount_without_discount": "6150.0000000000000000",
    "currency": "USD"
  },
  "promotions": [
    { … }
  ],
  "warnings": [
    { … }
  ]
}

장바구니 ID로 장바구니 아이템 삭제하기Client-side

요청

장바구니에서 아이템을 제거합니다.

보안
AuthForCart
경로
project_idinteger필수

프로젝트 ID입니다. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.

예제: 44056
cart_idstring필수

장바구니 ID입니다.

예제: custom_id
item_skustring필수

아이템 SKU입니다.

예제: booster_mega_1
curl -i -X DELETE \
  https://xsolla.redocly.app/_mock/ko/api/catalog/v2/project/44056/cart/custom_id/item/booster_mega_1 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

응답

장바구니에서 아이템을 성공적으로 삭제했습니다.

응답
콘텐츠 없음

장바구니 ID로 장바구니 아이템 업데이트하기Client-side

요청

기존 장바구니 아이템을 업데이트하거나 장바구니에서 아이템을 생성합니다.

보안
AuthForCart
경로
project_idinteger필수

프로젝트 ID입니다. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.

예제: 44056
cart_idstring필수

장바구니 ID입니다.

예제: custom_id
item_skustring필수

아이템 SKU입니다.

예제: booster_mega_1
본문application/json
quantitynumber

아이템 수량입니다.

기본값 123
curl -i -X PUT \
  https://xsolla.redocly.app/_mock/ko/api/catalog/v2/project/44056/cart/custom_id/item/booster_mega_1 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "quantity": 123
  }'

응답

장바구니를 성공적으로 업데이트했습니다.

응답
콘텐츠 없음

장바구니(서버 측)

작업

결제(클라이언트 측)

작업

결제(서버 측)

작업

주문

작업

무료 아이템

작업

관리

작업

관리자

작업

웹훅

작업

선주문

작업

판매자

작업

카탈로그

이 API를 사용하면 모든 종류의 판매할 수 있는 아이템 또는 특정 아이템을 가져올 수 있습니다.

작업

공통 지역

작업

관리자

작업