Xsolla-logo

가상 아이템 생성하기

post/v2/project/{project_id}/admin/items/virtual_items

가상 아이템을 생성합니다.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

프로젝트 ID입니다.

Example: 44056
Request Body schema: application/json
Array of objects <= 20 items

특성 목록입니다.

주의. 아이템에 20개 이상의 특성을 지정할 수 없습니다. 제한을 초과하려고 하면 오류가 발생합니다.
Array (<= 20 items)
external_id
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9-_]+$

고유한 특성 ID입니다. external_id에는 소문자 라틴어 영숫자, 대시, 밑줄만 사용할 수 있습니다.

required
Array of objects
주의. 각 특성 당 6개 이상의 값을 생성할 수 없습니다. 제한을 초과하려고 하면 오류가 발생합니다.
Array
required
object
Default: {"de":"Strategie","en":"Strategy"}

값의 이름에 대한 현지화가 있는 개체입니다. 키는 ISO 3166-1에 따라 지정되어 있습니다.

property name*
additional property
string
external_id
required
string [ 1 .. 255 ] characters ^[-_.\d\w]+$

특성의 고유한 값 ID입니다. external_id에는 소문자 라틴어 영숫자, 대시, 밑줄만 사용할 수 있습니다.

object
Default: {"de":"Genre","en":"Genre"}

특성의 이름에 대한 현지화가 있는 개체입니다. 키는 ISO 3166-1에 따라 지정되어 있습니다.

property name*
additional property
string
object

아이템 설명에 대한 현지화가 있는 개체입니다. 두 글자의 소문자 언어 코드입니다.

ar
string or null
bg
string or null
cn
string or null
cs
string or null
de
string or null
en
string or null
es
string or null
fr
string or null
he
string or null
it
string or null
ja
string or null
ko
string or null
pl
string or null
pt
string or null
ro
string or null
ru
string or null
th
string or null
tr
string or null
tw
string or null
vi
string or null
Array of objects

아이템이 속한 그룹입니다.

Array
external_id
string
image_url
string

이미지 URL입니다.

object

인벤토리 아이템 옵션을 정의합니다.

object or null

소모품 아이템인 경우 소모품 속성을 정의합니다. 소모품이 아닌 아이템인 경우 null입니다.

usages_count
integer or null

소모품 아이템인 경우 남은 남은 총 사용 횟수입니다. 소모품이 아닌 아이템인 경우 null입니다.

object or null

만료된 아이템인 경우 만료 속성을 정의합니다. 만료되지 않은 아이템인 경우 null입니다.

type
string

아이템 만료 유형을 정의합니다.

Enum: "minute" "hour" "day" "week" "month" "year"
value
integer

만료 기간의 값을 정의합니다.

is_deleted
boolean
is_enabled
boolean
is_free
boolean
Default: false

true일 경우 아이템은 무료입니다.

is_show_in_store
boolean
object

아이템 제한 사항입니다.

per_item
integer or null

전역 항목 제한 사항입니다.

per_user
integer or null

개별 사용자에 대한 아이템 제한 사항입니다.

object or null

Limit refresh period.

object or object or object
One of:

Daily type of user limits refresh.

interval_type
required
string

Recurrent refresh period.

Value: "daily"
time
required
string((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1...

Time of limit refresh in the desired time zone (rounding to hours).

object

아이템에 대한 현지화된 긴 설명이 있는 개체입니다. 두 글자의 소문자 언어 코드입니다.

ar
string or null
bg
string or null
cn
string or null
cs
string or null
de
string or null
en
string or null
es
string or null
fr
string or null
he
string or null
it
string or null
ja
string or null
ko
string or null
pl
string or null
pt
string or null
ro
string or null
ru
string or null
th
string or null
tr
string or null
tw
string or null
vi
string or null
Array of objects

스크린샷, 게임 플레이 동영상 등과 같은 아이템의 추가 자산입니다.

Array
type
string

미디어 유형: image/video.

Enum: "image" "video"
url
string

리소스 파일입니다.

object

아이템 이름에 대한 현지화가 있는 개체입니다. 두 글자의 소문자 언어 코드입니다.

ar
string or null
bg
string or null
cn
string or null
cs
string or null
de
string or null
en
string or null
es
string or null
fr
string or null
he
string or null
it
string or null
ja
string or null
ko
string or null
pl
string or null
pt
string or null
ro
string or null
ru
string or null
th
string or null
tr
string or null
tw
string or null
vi
string or null
order
integer

배열 순서를 정의합니다.

Array of objects or null

Item sales period.

Array
date_from
string <date-time>

Date when the specified item will be available for sale.

date_until
string or null <date-time>

Date when the specified item will become unavailable for sale. Can be null.

object
release_date
required
string or null <date-time>
is_enabled
required
boolean
description
string or null
Array of objects
Array
amount
required
number > 0

금액.

currency
required
string

기본 구매 통화입니다. ISO 4217에 따른 세 자리 글자 코드입니다.

country_iso
string

국가 형식은 ISO 3166-1 alpha-2 표준을 따라야 합니다.

is_default
boolean
Default: false
is_enabled
boolean
Default: true
Array of objects
Array
id
integer >= 1
sku
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

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

Array of objects
Array
amount
required
integer
is_default
required
boolean
Default: false
is_enabled
required
boolean
Default: false

가격이 활성화됩니다.

sku
string

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

Responses
201

가상 아이템을 성공적으로 생성했습니다.

422

잘못된 요청입니다.

Request samples
application/json
{
  • "attributes": [
    ],
  • "description": {
    },
  • "is_enabled": true,
  • "is_free": false,
  • "is_show_in_store": true,
  • "limits": {
    },
  • "name": {
    },
  • "order": 1,
  • "periods": [
    ],
  • "prices": [
    ],
  • "sku": "sword",
  • "vc_prices": [ ]
}
Response samples
application/json
{
  • "sku": "new-sku"
}