게임 생성하기

아이템 이름에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 언어 코드(예: en-US) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: en 및 en-US)이 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.

One of:

두 글자 소문자 언어 코드입니다.

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 히브리어
id	string or null 인도네시아어
it	string or null 이탈리아어
ja	string or null 일본어
km	string or null 크메르어
ko	string or null 한국어
lo	string or null 라오스어
my	string or null 버마어
ne	string or null 네팔어
ph	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 베트남어

required

Array of objects

다른 DRM용 게임 키입니다.

Array

sku

required

string [ 1 .. 255 ] characters

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

drm_sku

required

string

DRM 고유 ID입니다.

required

Array of objects

실제 통화 가격입니다.

Array

amount required	number
currency required	string 아이템 가격 통화입니다. ISO 4217에 따른 3자리 코드입니다. 엑솔라에서 지원하는 통화에 대한 자세한 정보는 설명서를 확인하십시오.
is_default required	boolean 기본 가격은 사용자 통화로 가격을 지정하지 않은 경우 카탈로그를 작성하는 데 사용됩니다.
is_enabled required	boolean

Array of objects

특성 목록입니다.

Array

external_id

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9-_]+$

고유 특성 ID입니다. external_id는 소문자 및 대문자 라틴 영숫자, 대시 및 밑줄만 포함할 수 있습니다.

required

Array of objects

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

Array of objects

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

Array

external_id

required

string

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

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

interval_type = daily (object) or interval_type = 주간 (object) or interval_type = 월간 (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... 원하는 시간대의 제한 시간 새로고침 시간입니다(시간 단위로 반올림).

(two-letter (object or null)) or (five-letter (object or null))

One of:

두 글자 소문자 언어 코드입니다.

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 히브리어
id	string or null 인도네시아어
it	string or null 이탈리아어
ja	string or null 일본어
km	string or null 크메르어
ko	string or null 한국어
lo	string or null 라오스어
my	string or null 버마어
ne	string or null 네팔어
ph	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

아이템 판매 기간입니다.

Array

date_from	string <date-time> 지정된 아이템을 판매할 수 있는 날짜입니다.
date_until	string or null <date-time> 지정된 아이템을 판매할 수 없게 되는 날짜입니다. `null`일 수 있습니다.

object

사전 판매 설정입니다.

release_date required	string ISO 8601 형식으로 된 게임 키 출시 날짜입니다.
is_enabled required	boolean 비활성화된 경우 해당 아이템은 사전 판매 대상이 아닙니다.
description	string 사전 판매에 대한 추가 정보는 이메일로 전송됩니다.

Array of objects

Array

integer

Array of objects

Array

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

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

(two-letter (object or null)) or (five-letter (object or null))

아이템 설명에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 로케일 코드(예: en-US) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: en 및 en-US)이 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.

One of:

두 글자 소문자 언어 코드입니다.

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 히브리어
id	string or null 인도네시아어
it	string or null 이탈리아어
ja	string or null 일본어
km	string or null 크메르어
ko	string or null 한국어
lo	string or null 라오스어
my	string or null 버마어
ne	string or null 네팔어
ph	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

required

string

image_url

string

이미지 URL입니다.

is_enabled

boolean

비활성화된 경우 인벤토리를 통해 아이템을 구매하고 액세스할 수 없습니다.

is_show_in_store

boolean

아이템을 구매할 수 있는 상태입니다.

(two-letter (object or null)) or (five-letter (object or null))

아이템의 긴 설명에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 5자 로케일 코드(예 en-US: ) 두 가지 형식 중 하나로 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 변수(예: en 및 en-US)가 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.

Any of:

두 글자 소문자 언어 코드입니다.

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 히브리어
id	string or null 인도네시아어
it	string or null 이탈리아어
ja	string or null 일본어
km	string or null 크메르어
ko	string or null 한국어
lo	string or null 라오스어
my	string or null 버마어
ne	string or null 네팔어
ph	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

목록에서 게임의 주문 우선 순위입니다.

Responses

201

게임을 성공적으로 생성했습니다.

401

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

422

잘못된 요청입니다.

Request samples

application/json

{"description": {"en-US": "Game description",
"ru-RU": "Краткое описание игры"
},
"groups": ["new_games"
],
"image_url": "http://image.png",
"is_enabled": true,
"is_show_in_store": true,
"long_description": {"en-US": "Game long description",
"ru-RU": "Полное описание игры"
},
"media_list": [{"type": "image",
"url": "http://image.png"
},
{"type": "video",
"url": "http://video.png"
}
],
"name": {"en-US": "Game name",
"ru-RU": "Название игры"
},
"sku": "com.xsolla.game_1",
"unit_items": [{"drm_sku": "steam_key_1",
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {"per_item": {"available": 5000,
"reserved": 500,
"sold": 4500,
"total": 10000
},
"per_user": {"total": 5
}
},
"name": {"en-US": "Game key name",
"ru-RU": "Название игрового ключа"
},
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"pre_order": {"description": "Some description",
"is_enabled": true,
"release_date": "2020-08-11T10:00:00+03:00"
},
"prices": [{"amount": 35.5,
"currency": "USD",
"is_default": true,
"is_enabled": true
}
],
"regions": [{"id": 12
},
{"id": 64
}
],
"sku": "com.xsolla.game_key_1",
"vc_prices": [{"amount": 35.5,
"is_default": true,
"is_enabled": true,
"sku": "com.xsolla.gold_1"
}
]
}
]
}

Response samples

application/json

{"item_id": 101,
"sku": "com.xsolla.game_1"
}