Spiel anhand der ID aktualisieren

project_id required	integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt. Example: 44056
item_id required	string Item ID. Example: 656

Request Body schema: application/json

Objekt mit Spieldaten.

sku

required

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

Eindeutige Artikel-ID. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.

required

object

Objekt mit lokalisierten Namen des Artikels. Sprachencode bestehend aus zwei Kleinbuchstaben.

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

required

Array of objects

Spielschlüssel für verschiedene DRMs.

Array

sku

required

string [ 1 .. 255 ] characters

Eindeutige Artikel-ID. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.

drm_sku

required

string

Eindeutige DRM-ID.

required

Array of objects

Preise in echten Währungen.

Array

amount required	number
currency required	string Währung des Artikelpreises. Dreistelliger Code pro ISO 4217. Detaillierte Informationen zu Von Xsolla unterstützte Währungen.
is_default required	boolean Der Standardpreis dient dazu, den Katalog zu erstellen, wenn kein Preis in der Währung des Benutzers angegeben ist.
is_enabled required	boolean

Array of objects

Liste der Attribute.

Array

external_id

required

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

Eindeutige Attribut-ID. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten.

required

Array of objects

Array

required

object

Default: {"de":"Strategie","en":"Strategy"}

Objekt mit lokalisierten Wertnamen. Schlüssel sind in ISO 3166-1 spezifiziert.

property name*

additional property

string

external_id

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

Eindeutige Wert-ID für ein Attribut. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten.

object

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

Objekt mit lokalisierten Attributnamen. Schlüssel sind in ISO 3166-1 spezifiziert.

property name*

additional property

string

Array of objects

Gruppen, zu denen der Artikel gehört.

Array

external_id

required

string

is_enabled

boolean

Ist diese Option deaktiviert, kann der Artikel weder gekauft noch über das Inventar aufgerufen werden.

is_free

boolean

Default: false

Ist true eingestellt, ist der Artikel kostenlos.

is_show_in_store

boolean

Artikel ist käuflich erhältlich.

object

Artikelbeschränkungen.

per_item

integer or null

Globale Artikelbeschränkung.

per_user

integer or null

Artikelbeschränkung für einen separaten Benutzer.

object or null

Aktualisierungszeitraum begrenzen.

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

One of:

Tägliche Aktualisierung der Benutzerlimits.

interval_type required	string Wiederkehrender Aktualisierungszeitraum. Value: "daily"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... Zeitpunkt der Limitaktualisierung in der gewünschten Zeitzone (auf Stunden gerundet).

object

Objekt mit lokalisierten Namen des Artikels. Sprachencode bestehend aus zwei Kleinbuchstaben.

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

Priorität der Spielreihenfolge in der Liste.

Array of objects or null

Artikelangebotszeitraum.

Array

date_from	string <date-time> Datum, an dem der angegebene Artikel zum Verkauf angeboten wird.
date_until	string or null <date-time> Datum, an dem der angegebene Artikel nicht mehr zum Verkauf angeboten wird. Möglich ist: `null`.

object

Vorbestelleinstellungen.

release_date required	string Release-Termin des Spielschlüssels im Format ISO 8601.
is_enabled required	boolean Wenn diese Option deaktiviert ist, kann der Artikel nicht vorbestellt werden.
description	string Zusätzliche Vorbestellinformationen, die per E-Mail verschickt werden.

Array of objects

Array

integer

Array of objects

Array

amount required	number
is_default required	boolean
is_enabled required	boolean
sku	string Eindeutige Artikel-ID. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.

Array of objects <= 20 items

Liste der Attribute.

Achtung: Sie können für den Artikel maximal 20 Attribute angeben. Jeder Versuch, das Limit zu überschreiten, führt zu einem Fehler.

Array (<= 20 items)

external_id

required

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

Eindeutige Attribut-ID. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten.

required

Array of objects

Achtung: Sie können für jedes Attribut maximal 6 Werte erstellen. Jeder Versuch, das Limit zu überschreiten, führt zu einem Fehler.

Array

required

object

Default: {"de":"Strategie","en":"Strategy"}

Objekt mit lokalisierten Wertnamen. Schlüssel sind in ISO 3166-1 spezifiziert.

property name*

additional property

string

external_id

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

Eindeutige Wert-ID für ein Attribut. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten.

object

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

Objekt mit lokalisierten Attributnamen. Schlüssel sind in ISO 3166-1 spezifiziert.

property name*

additional property

string

object

Objekt mit lokalisierten Beschreibungen des Artikels. Sprachencode bestehend aus zwei Kleinbuchstaben.

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

Gruppen, zu denen der Artikel gehört.

Array

external_id

required

string

image_url

string

Bild-URL.

is_enabled

boolean

Ist diese Option deaktiviert, kann der Artikel weder gekauft noch über das Inventar aufgerufen werden.

is_show_in_store

boolean

Artikel ist käuflich erhältlich.

object

Objekt mit lokalisierten langen Beschreibungen des Artikels. Sprachencode bestehend aus zwei Kleinbuchstaben.

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

Zusätzliche Spiel-Medieninhalte wie Screenshots, Gameplay-Videos usw.

Array

type	string Medieninhaltstyp: `image`/`video`. Enum: "image" "video"
url	string Ressourcendatei.

order

integer

Priorität der Spielreihenfolge in der Liste.

Responses

201

Spiel wurde erfolgreich aktualisiert.

401

Basisauthentifizierung nicht bestanden oder falsch. Prüfen Sie die Anmeldedaten und vergewissern Sie sich, dass Sie die Basisauthentifizierung verwenden.

404

Spiel nicht gefunden.

422

Ungültige Anfrage.

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": "game_1",
"unit_items": [{"drm_sku": "steam",
"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": "game_key_1",
"vc_prices": [{"amount": 35.5,
"is_default": true,
"is_enabled": true,
"sku": "gold"
}
]
}
]
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}