Xsolla-logoXsolla Developers
또는
관리자 페이지로

아이템으로 장바구니 채우기Server-side

put/v2/admin/project/{project_id}/cart/fill

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

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

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

Example: 44056
query Parameters
locale
string
Default: "en"

응답 언어입니다. ISO 639-1에 따른 두 자리 소문자 언어 코드입니다.

header Parameters
x-user-for
string

사용자 식별자는 엑솔라 로그인 사용자 JWT 또는 페이 스테이션 액세스 토큰을 사용하여 전송할 수 있습니다.

Example: ACCESS_TOKEN/LOGIN_JWT
x-user-id
string <= 32 characters

게임이 포함된 장바구니를 판매할 때 자신의 사용자 ID를 사용할 수 있습니다.

Example: UNIQUE_ID
Request Body schema: application/json
required
Array of objects non-empty
Array (non-empty)
sku
required
string non-empty

고유한 아이템 ID입니다. SKU는 소문자 및 대문자 라틴 영숫자, 마침표, 대시 및 밑줄만 포함할 수 있습니다.

quantity
required
number >= 1

아이템의 수량입니다.

country
string = 2 characters

ISO 3166-1 alpha-2에 따른 2자리 대문자 국가 코드입니다. 엑솔라에서 지원하는 국가에 대한 자세한 정보는 설명서를 확인하십시오.
예: country=US

currency
string = 3 characters

장바구니에 표시되는 아이템 가격 통화입니다. ISO 4217에 따른 3자리 코드입니다. 엑솔라에서 지원하는 통화에 대한 자세한 정보는 설명서를 확인하십시오.

Responses
200

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

401

기본 인증이 전달되지 않았거나 잘못되었습니다. 기본 인증 또는 올바른 자격 증명을 사용했는지 확인해야 합니다.

404

사용자를 찾을 수 없습니다. x-user-for 또는 x-user-id 토큰이 올바른지 확인해야 합니다.

422

장바구니가 잘못되었습니다. 장바구니가 존재하는지, 장바구니가 비어 있지 않은지, 장바구니에 있는 모든 아이템이 무료가 아닌지 확인해야 합니다.

Request samples
application/json
{
  • "currency": "USD",
  • "items": [
    ]
}
Response samples
application/json
{
  • "cart_id": "cart_id",
  • "is_free": false,
  • "items": [],
  • "price": {
    },
  • "promotions": [],
  • "warnings": [
    ]
}
System statusAll services operational

Privacy Settings

Privacy PolicyEnd User License Agreement© 2006–2025 Xsolla Inc.