Bundle aktualisieren

project_id required	integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt. Example: 44056
sku required	string Bundle-SKU. Example: kg_1

Request Body schema: application/json

Objekt mit Bundle-Daten.

sku

required

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

Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.

required

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

Objekt mit Lokalisierungen für Artikelnamen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Optionen angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der Dokumentation.

One of:

Sprachencodes bestehend aus zwei Kleinbuchstaben.

ar	string or null Arabisch
bg	string or null Bulgarisch
cn	string or null Chinesisch (vereinfacht)
cs	string or null Tschechisch
de	string or null Deutsch
en	string or null Englisch
es	string or null Spanisch (Spanien)
fr	string or null Französisch
he	string or null Hebräisch
id	string or null Indonesisch
it	string or null Italienisch
ja	string or null Japanisch
km	string or null Khmer
ko	string or null Koreanisch
lo	string or null Laotisch
my	string or null Birmanisch
ne	string or null Nepalesisch
ph	string or null Filipino
pl	string or null Polnisch
pt	string or null Portugiesisch
ro	string or null Rumänisch
ru	string or null Russisch
th	string or null Thai
tr	string or null Türkisch
tw	string or null Chinesisch (traditionell)
vi	string or null Vietnamesisch

required

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

Objekt mit Lokalisierungen für Artikelbeschreibungen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Optionen angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der Dokumentation.

One of:

Sprachencodes bestehend aus zwei Kleinbuchstaben.

ar	string or null Arabisch
bg	string or null Bulgarisch
cn	string or null Chinesisch (vereinfacht)
cs	string or null Tschechisch
de	string or null Deutsch
en	string or null Englisch
es	string or null Spanisch (Spanien)
fr	string or null Französisch
he	string or null Hebräisch
id	string or null Indonesisch
it	string or null Italienisch
ja	string or null Japanisch
km	string or null Khmer
ko	string or null Koreanisch
lo	string or null Laotisch
my	string or null Birmanisch
ne	string or null Nepalesisch
ph	string or null Filipino
pl	string or null Polnisch
pt	string or null Portugiesisch
ro	string or null Rumänisch
ru	string or null Russisch
th	string or null Thai
tr	string or null Türkisch
tw	string or null Chinesisch (traditionell)
vi	string or null Vietnamesisch

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 Klein- und Großbuchstaben, Ziffern, Bindestriche 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

Array of objects non-empty

Array (non-empty)

sku required	string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$ Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.
quantity	integer >= 1 Default: 1 Menge der ausgewählten Artikel im Bundle.

custom_attributes

object <json> <= 500 characters

Ein JSON-Objekt mit den Artikelattributen und ‑werten. Attribute ermöglichen es Ihnen, Artikeln weitere Informationen hinzuzufügen, z. B. das Mindestlevel des Spielers, um den Artikel verwenden zu können. Attribute bereichern die interne Logik Ihres Spiels und sind über spezielle GET-Methoden und Webhooks abrufbar.

groups

Array of strings

Default: []

Gruppen, zu denen der Artikel gehört.

Hinweis: Der String-Wert bezieht sich auf die Gruppe `external_id`.

image_url

string or null

Bild-URL.

is_enabled

boolean

Default: true

Ist diese Option deaktiviert, kann der Artikel weder gefunden noch gekauft werden.

is_free

boolean

Default: false

Ist true eingestellt, ist der Artikel kostenlos.

is_show_in_store

boolean

Default: false

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 Nutzer.

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 Nutzerlimits.

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).

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

Objekt mit Lokalisierungen für lange Artikelbeschreibungen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Varianten angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der Dokumentation.

Any of:

Sprachencodes bestehend aus zwei Kleinbuchstaben.

ar	string or null Arabisch
bg	string or null Bulgarisch
cn	string or null Chinesisch (vereinfacht)
cs	string or null Tschechisch
de	string or null Deutsch
en	string or null Englisch
es	string or null Spanisch (Spanien)
fr	string or null Französisch
he	string or null Hebräisch
id	string or null Indonesisch
it	string or null Italienisch
ja	string or null Japanisch
km	string or null Khmer
ko	string or null Koreanisch
lo	string or null Laotisch
my	string or null Birmanisch
ne	string or null Nepalesisch
ph	string or null Filipino
pl	string or null Polnisch
pt	string or null Portugiesisch
ro	string or null Rumänisch
ru	string or null Russisch
th	string or null Thai
tr	string or null Türkisch
tw	string or null Chinesisch (traditionell)
vi	string or null Vietnamesisch

Array of objects or null

Zusätzliche Medieninhalte des Bundles.

Array

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

order

integer

Default: 1

Priorität der Bundle-Reihenfolge 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`.

Array of objects

Preise in echten Währungen.

Array

amount required	string^\d\.?\d$ Artikelpreis.
currency required	string Währung des Artikelpreises. Dreistelliger Code pro ISO 4217.
is_default required	boolean Der Standardpreis dient dazu, einen Katalog zu erstellen, wenn kein Preis in der Währung des Nutzers angegeben ist.
is_enabled required	boolean Der Preis ist aktiviert.
country_iso	string or null Land, in dem dieser Preis gilt. Code bestehend aus zwei Buchstaben gemäß ISO 3166-1 Alpha 2.

Array of objects

Array

id	integer >= 1

Array of objects or null

Array

amount required	integer
is_default required	boolean
is_enabled required	boolean
sku	string Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.

Responses

204

Bundle wurde erfolgreich aktualisiert.

401

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

422

Ungültige Anfrage.

Request samples

application/json

{"attributes": [{"external_id": "class",
"name": {"en": "Class"
},
"values": [{"external_id": "soldier",
"value": {"en": "Soldier"
}
},
{"external_id": "officer",
"value": {"en": "Officer"
}
}
]
}
],
"content": [{"quantity": 1,
"sku": "com.xsolla.iron_gloves_1"
},
{"quantity": 1,
"sku": "com.xsolla.iron_boots_1"
},
{"quantity": 1,
"sku": "com.xsolla.iron_shield_1"
},
{"quantity": 1,
"sku": "com.xsolla.iron_armour_1"
},
{"quantity": 1,
"sku": "com.xsolla.iron_helmet_1"
}
],
"custom_attributes": {"purchased": 0,
"type": "lootbox"
},
"description": {"de": "Brustpanzer für Soldaten",
"en": "Chest of armour for soldiers"
},
"groups": ["chests"
],
"image_url": "https://picture.bundle-with-many-stuff.png",
"is_enabled": true,
"is_free": true,
"limits": {"per_item": null,
"per_user": null
},
"long_description": {"de": "Brustpanzer für Soldaten",
"en": "Chest of armour for soldiers"
},
"media_list": [{"type": "image",
"url": "https://test.com/image0"
},
{"type": "image",
"url": "https://test.com/image1"
}
],
"name": {"de": "Brustpanzer",
"en": "Chest of armour"
},
"order": 1,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [{"amount": "9.99",
"currency": "USD",
"is_default": true,
"is_enabled": true
},
{"amount": "9.99",
"currency": "EUR",
"is_default": false,
"is_enabled": true
}
],
"sku": "com.xsolla.armour_chest_1",
"vc_prices": [ ]
}

Response samples

application/json

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