# Shop Builder API # Overview * **Version:** 2.0.0 * **Servers**: `https://store.xsolla.com/api` * **[Contact Us by Email](mailto:integration@xsolla.com)** * **Contact URL:** https://xsolla.com/ * **Required TLS version:** 1.2 Shop Builder API provides a third-party solution for implementing the server side for your store interface. Use the endpoints to manage in-game items, in-game currencies, cart, player inventory, promotions, game library, etc. Version: 2.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### XsollaLoginUserJWT Standardmäßig wird der Xsolla-Login-Benutzer-JWT (Trägertoken) bei der Autorisierung verwendet. Sie können versuchen, diesen Endpunkt mit einem speziell für Testzwecke bestehenden Xsolla-Login-Benutzer-JWT aufzurufen: `Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`. Alternativ können Sie den [Zugriffstoken der Bezahlstation](https://developers.xsolla.com/de/api/pay-station/operation/create-token/) verwenden. Type: http Scheme: bearer Bearer Format: JWT ### basicAuth Die Xsolla-API nutzt die Basisauthentifizierung. Alle Anfragen an die API müssen den Header `Authorization: Basic ` enthalten, wobei `your_authorization_basic_key` das gemäß Base64-Standard kodierte `project_id:api_key`-Paar ist. Sie können bei Bedarf `merchant_id` anstelle von `project_id` verwenden. Dies hat keine Auswirkungen auf die Funktionalität. Wechseln Sie ins [Kundenportal](https://publisher.xsolla.com/), um die Werte der Parameter zu erhalten: * Die `merchant_id` wird an folgenden Orten angezeigt: * unter **Firmeneinstellungen > Firma** * In der URL in der Adressleiste des Browsers auf jeder beliebigen Publisher- Kontoseite. Die URL hat das folgende Format: `https://publisher.xsolla.com/`. * Der `api_key` wird im Kundenportal nur einmal angezeigt, nämlich dann, wenn er erstellt wird. Sie sind selbst dafür verantwortlich, den Schlüssel zu speichern. Einen neuen Schlüssel können Sie in den folgenden Abschnitten erstellen: * **Firmeneinstellungen > API-Schlüssel** * **Projekteinstellungen > API-Schlüssel** * Die `project_id` wird an folgenden Orten angezeigt: * Im Kundenportal neben dem Projektnamen. * In der URL in der Adressleiste des Browsers, wenn Sie im Publisher-Konto an einem Projekt arbeiten. Die URL hat das folgende Format: `https://publisher.xsolla.com//Projekte/`. Weitere Informationen zur Handhabung von API-Schlüsseln finden Sie in der [API- Referenz](https://developers.xsolla.com/de/api/getting-started/#api_keys_overview). Type: http Scheme: basic ## Download OpenAPI description [Shop Builder API](https://developers.xsolla.com/_bundle/@l10n/de/api/deprecated/inventory/index.yaml) ## Client ### Artikel verbrauchen - [POST /v2/project/{project_id}/user/inventory/item/consume](https://developers.xsolla.com/de/api/deprecated/inventory/inventory-client/consume-item.md): Client-Endpunkt. Verbraucht einen Artikel aus dem Inventar des aktuellen Benutzers. ### Inventar des aktuellen Benutzers abrufen - [GET /v2/project/{project_id}/user/inventory/items](https://developers.xsolla.com/de/api/deprecated/inventory/inventory-client/get-user-inventory.md): Client-Endpunkt. Ruft das Inventar des aktuellen Benutzers ab. AchtungBei allen Projekten ist die Anzahl der Artikel begrenzt, die Sie in der Antwort erhalten können. Der Standard- und Höchstwert beträgt 50 Artikel pro Antwort. Um pro Seite mehr Daten zu erhalten, verwenden Sie die Felder limit und offset. ### Zeitlich begrenzte Artikel des aktuellen Benutzers abrufen - [GET /v2/project/{project_id}/user/time_limited_items](https://developers.xsolla.com/de/api/deprecated/inventory/inventory-client/get-user-subscriptions.md): Client-Endpunkt. Ruft die zeitlich begrenzten Artikel des aktuellen Benutzers ab. ### Virtuelles Guthaben des aktuellen Benutzers abrufen - [GET /v2/project/{project_id}/user/virtual_currency_balance](https://developers.xsolla.com/de/api/deprecated/inventory/inventory-client/get-user-virtual-balance.md): Client-Endpunkt. Ruft das virtuelle Guthaben des aktuellen Benutzers ab. ## Verwaltung ### Benutzern gekaufte Artikel gewähren - [POST /v2/project/{project_id}/inventory/purchase](https://developers.xsolla.com/de/api/deprecated/inventory/inventory-management/grant-item-by-purchase.md): Fügt die angegebenen, gekauften Artikel dem angegebenen Benutzerinventaren hinzu. AchtungEs können nur 50 Vorgänge gleichzeitig verarbeitet werden. Vorgänge, die dieses Limit überschreiten, werden ignoriert. ### Inventarartikel widerrufen - [POST /v2/project/{project_id}/inventory/revoke](https://developers.xsolla.com/de/api/deprecated/inventory/inventory-management/revoke-item.md): Widerruft den Zugriff auf Artikel für mehrere Benutzer. AchtungEs können nur 50 Vorgänge gleichzeitig verarbeitet werden. Vorgänge, die dieses Limit überschreiten, werden ignoriert. ### Benutzern Artikel gewähren - [POST /v2/project/{project_id}/inventory/reward](https://developers.xsolla.com/de/api/deprecated/inventory/inventory-management/add-item-to-inventory.md): Fügt die angegebenen Artikel dem angegebenen Benutzerinventaren hinzu. AchtungEs können nur 50 Vorgänge gleichzeitig verarbeitet werden. Vorgänge, die dieses Limit überschreiten, werden ignoriert. ### Artikel für Benutzer festlegen - [POST /v2/project/{project_id}/inventory/set](https://developers.xsolla.com/de/api/deprecated/inventory/inventory-management/set-item-quantity.md): Legt angegebene Artikel für angegebene Benutzerinventare fest. Beachten Sie, dass neue Daten alte Daten ersetzen. AchtungEs können nur 50 Vorgänge gleichzeitig verarbeitet werden. Vorgänge, die dieses Limit überschreiten, werden ignoriert. ## Inventarübergreifend ### Spielkonto mit Xsolla verknüpfen - [POST /v2/project/{project_id}/inventory/account/link](https://developers.xsolla.com/de/api/deprecated/inventory/cross-inventory/inventory-account-link.md): Verknüpft das Spielkonto des Benutzers mit dem Xsolla-Konto. ### Benutzertokenisierung - [POST /v2/project/{project_id}/inventory/account/signin](https://developers.xsolla.com/de/api/deprecated/inventory/cross-inventory/inventory-account-signin.md): Ruft den JWT für Benutzer Ihrer Publishing-Plattform ab, um mit der Shop Builder API zu arbeiten.