인게임 재화 생성하기

인게임 재화 생성하기Server-sideAdmin

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

인게임 재화를 생성합니다.

Request

path Parameters

project_id

required

integer

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

Example: 44056

Request Body schema: application/json

sku

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

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

required

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 <= 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

custom_attributes

object <json> <= 500 characters

아이템 특성과 값이 포함된 JSON 개체입니다. 특성을 사용하면 아이템을 사용할 수 있는 플레이어의 레벨과 같은 추가 정보를 아이템에 추가할 수 있습니다. 특성은 게임의 내부 논리를 강화하며 전용 GET 메소드와 웹훅을 통해 이용할 수 있습니다.

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

Default: []

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

Array

external_id

string

object

Default: {"en":"Horror"}

아이템의 이름입니다. 키가 "^[a-z]{2}" 형식의 로케일인 키/값 쌍을 포함해야 하며 값은 문자열입니다.

additionalProperties

string

image_url

string

is_deleted

boolean

is_enabled

boolean

is_free

boolean

Default: false

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

is_hard

boolean

is_show_in_store

boolean

object

아이템 제한 사항입니다.

per_item

integer or null

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

per_user

integer or null

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

object or null

새로고침 기간을 제한합니다.

interval_type = daily (object) or interval_type = weekly (object) or interval_type = monthly (object)

One of:

일일 사용자 유형 제한 설정을 새로고침합니다.

interval_type required	string 반복 새로고침 기간입니다. Value: "daily"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... 원하는 시간대의 제한 시간 새로고침 시간입니다(시간 단위로 반올림).

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 리소스 파일입니다.

order

integer

배열 순서를 정의합니다.

Array of objects or null

아이템 판매 기간입니다.

Array

date_from	string <date-time> 지정된 아이템을 판매할 수 있는 날짜입니다.
date_until	string or null <date-time> 지정된 아이템을 판매할 수 없게 되는 날짜입니다. `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 품목 가격 통화. 3자리 코드 ISO 4217. 자세한 내용은 설명서를 확인하세요. Xsolla에서 지원하는 통화.
country_iso	string or null 이 가격을 사용할 수 있는 국가입니다. ISO 3166-1 alpha 2에 따른 2자리 글자 코드입니다.
is_default	boolean Default: false
is_enabled	boolean Default: true

Array of objects

Array

id	integer >= 1

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": [{"external_id": "material",
"name": {"en-US": "Material"
},
"values": [{"external_id": "gold",
"value": {"en-US": "Gold"
}
}
]
}
],
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": {"de-DE": "Die Hauptwährung deines Königreichs",
"en-US": "The main currency of your kingdom"
},
"groups": ["gold"
],
"is_enabled": true,
"is_free": false,
"limits": {"per_item": 10000,
"per_user": 5
},
"name": {"de-DE": "Goldmünze",
"en-US": "Gold coin"
},
"order": 1,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [{"amount": 100,
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"sku": "coin"
}

Response samples

application/json

{"sku": "new-sku"
}