Benutzern Artikel gewähren

Digital Distribution Hub API

In-Game Store & Buy Button API

Überblick

API-Definition herunterladen

BENUTZERATTRIBUTE

Administrator

Personalisierter Katalog

BUNDLES

Administrator

Katalog

WARENKORB UND ZAHLUNG

Warenkorb (clientseitig)

Warenkorb (serverseitig)

Zahlung (clientseitig)

Zahlung (serverseitig)

Bestellung

Kostenlose Artikel

ALLGEMEINES

Webhooks

Vorbestellungen

Händler

Katalog

Gängige Regionen

SPIELSCHLÜSSEL

Katalog

Berechtigung

Administrator

SPIELERINVENTAR

Client

Verwaltung

post

Benutzern gekaufte Artikel gewähren

post

Inventarartikel widerrufen

post

Benutzern Artikel gewähren

post

Artikel für Benutzer festlegen

Inventarübergreifend

WERBEAKTIONEN

Allgemeines

Gutscheine

Promocodes

Katalogsonderangebote

Rabatte

Prämien

VIRTUELLE GEGENSTÄNDE UND WÄHRUNG

Administrator

Katalog

Virtuelle Zahlung

NFT-ARTIKEL

Administrator

Katalog

LIMITS

Verwaltung

REWARD CHAINS & VALUE POINTS

Administrator

Client

Pay Station API

Publisher Account API

Subscriptions API

Webhooks

Benutzern Artikel gewähren

post/v2/project/{project_id}/inventory/reward

Fügt die angegebenen Artikel dem angegebenen Benutzerinventaren hinzu.

Achtung

Es können nur 50 Vorgänge gleichzeitig verarbeitet werden. Vorgänge, die dieses Limit überschreiten, werden ignoriert.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

Default: 44056

Projekt-ID.

Request Body schema: application/json

Array

required

object

id	string Default: "d342dad2-9d59-11e9-a384-42010aa8003f" Die eindeutige Benutzerkennung auf der Plattform.

required

Array of objects non-empty

Array (non-empty)

sku required	string Default: "booster_mega_1" Artikelklassenkennung. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.
quantity required	number Default: 1 Anzahl der Artikel dieser Klasse, die gewährt werden müssen.

comment

string [ 1 .. 255 ] characters

Default: "Monthly challenge rewards"

Vorgangsbeschreibung. Zum Beispiel: „Belohnungen für monatliche Herausforderung“.

platform

string

Default: "xsolla"

Publishing-Plattform, auf der der Benutzer spielt.

Enum: "playstation_network" "xbox_live" "xsolla" "pc_standalone" "nintendo_shop" "google_play" "app_store_ios" "android_standalone" "ios_standalone" "android_other" "ios_other" "pc_other"

Responses

200

Erfolgreiche Benutzerbelohnung.

404

Artikel für Projekt nicht gefunden.

Request samples

application/json

[{"comment": "Monthly challenge rewards",
"items": [{"quantity": 1,
"sku": "booster_mega_1"
}
],
"platform": "playstation_network",
"user": {"id": "d342dad2-9d59-11e9-a384-42010aa8003f"
}
}
]

Response samples

application/json

{"count": 2,
"operations": [{"comment": "Quest completed",
"items": [{"balance": 5,
"quantity": 5,
"sku": "boots_1"
},
{"balance": 3,
"quantity": 3,
"sku": "crystal_pack_1"
}
],
"platform": "xsolla",
"user_id": "0125760a-6810-11e9-84c0-42010aa80029"
},
{"comment": "Daily reward",
"items": [{"balance": 5,
"quantity": 2,
"sku": "helmet_1"
},
{"balance": 5,
"quantity": 3,
"sku": "minigun_1"
}
],
"platform": "xsolla",
"user_id": "a7d10a4e-3f68-43cc-a6b2-893d2c68fd14"
}
]
}