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

게임 생성하기Server-sideAdmin

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

프로젝트에서 게임을 생성합니다.

SecuritybasicAuth
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
(two-letter (object or null)) or (five-letter (object or null))

아이템 이름에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 언어 코드(예 en-US: ) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: enen-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))

아이템 이름에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 언어 코드(예 en-US: ) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: enen-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

베트남어

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
id
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: ) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: enen-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: ) 두 가지 형식 중 하나로 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 변수(예: enen-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": {
    },
  • "groups": [
    ],
  • "image_url": "http://image.png",
  • "is_enabled": true,
  • "is_show_in_store": true,
  • "long_description": {
    },
  • "media_list": [],
  • "name": {
    },
  • "sku": "com.xsolla.game_1",
  • "unit_items": [
    ]
}
Response samples
application/json
{
  • "item_id": 101,
  • "sku": "com.xsolla.game_1"
}