Der Importstatus wurde erfolgreich abgerufen.
Katalog-API (2.0.0)
- Version: 2.0.0
- Server:
https://store.xsolla.com/api - Kontakt per E-Mail
- Kontakt-URL: https://xsolla.com/
- Erforderliche TLS-Version: 1.2
Mit der Katalog-API können Sie aufseiten von Xsolla einen Katalog mit Ingame-Items konfigurieren und diesen Katalog den Nutzern in Ihrem Shop anzeigen.
Über die API können Sie die folgenden Katalogentitäten verwalten:
- Virtuelle Gegenstände – Ingame-Items wie etwa Waffen, Skins, Booster.
- Virtuelle Währung – Virtuelles Geld für den Kauf von virtuellen Gütern.
- Virtuelle Währungspakete – vordefinierte Pakete voller virtueller Währung.
- Bundles – eine Kombination aus virtuellen Gegenständen, Währung oder Spielschlüsseln. Bundles werden als eine einzelne SKU verkauft.
- Spielschlüssel – Schlüssel für Spiele oder DLCs, die über Plattformen wie Steam oder andere DRM-Anbieter vertrieben werden.
- Gruppen – logische Gruppierungen, um Artikel im Katalog zu organisieren und zu sortieren.
Die API ist in die folgenden Gruppen unterteilt:
Admin – Aufrufe zum Erstellen, Aktualisieren, Löschen und Konfigurieren von Katalogartikeln und ‑gruppen. Die Authentifizierung erfolgt über die Basisauthentifizierung und Ihre Händler- oder Projekt-Anmeldedaten. Diese Aufrufe sind nicht für den Storefront bestimmt.Catalog – Aufrufe zum Abrufen von Artikeln und zum Erstellen benutzerdefinierter Storefronts für Endnutzer. Konzipiert für den Einsatz unter hoher Auslastung. Unterstützt die optionale Nutzer-JWT-Autorisierung und kann personalisierte Daten (z. B. benutzerspezifische Limits und aktive Werbeaktionen) zurückgeben.
OpenAPI-Beschreibung herunterladen
Sprachen
Server
https://store.xsolla.com/api/
Mock server
https://xsolla.redocly.app/_mock/de/api/catalog/
Pfad
Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.
Beispiel: 44056
- https://connector.xsolla.com/v1/admin/projects/{project_id}/connectors/import_items/import/status
- Mock serverhttps://xsolla.redocly.app/_mock/de/api/catalog/v1/admin/projects/{project_id}/connectors/import_items/import/status
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
https://connector.xsolla.com/v1/admin/projects/44056/connectors/import_items/import/statusDer Zeitstempel für den Abschluss des Importvorgangs. Datum und Uhrzeit sind in der Zeitzone GMT+3 angegeben. Wenn der Import aufgrund eines Fehlers unterbrochen wurde und keine Artikel importiert wurden, wird ein leerer String zurückgegeben.
Beispiel: "2024-11-19T15:27:31+03:00"
Der Zeitstempel für die Erstellung des Importvorgangs. Datum und Uhrzeit sind in der Zeitzone GMT+3 angegeben.
Beispiel: "2024-11-19T14:27:31+03:00"
Der Zeitstempel für den Zeitpunkt, als der Import aufgrund eines Fehlers unterbrochen wurde. Datum und Uhrzeit sind in der Zeitzone GMT+3 angegeben.
Beispiel: "2024-11-19T15:27:31+03:00"
Ein Objekt mit Daten zu den Importergebnissen und Importfehlern für bestimmte Artikel-SKU.
Beispiel: {"errors_by_sku":[{"error_code":4055,"error_message":"[0401-4055]: Item default price not set","sku":"com.xsolla.sword_1","type":"virtual_items"},{"error_code":1817,"error_message":"[0410-1817]: SKU can't be empty","sku":"","type":null}],"errors_count":2,"total_entities_count":10}
Antwort
application/json
{ "date_completed": "2024-11-19T15:27:31+03:00", "date_created": "2024-11-19T14:27:31+03:00", "date_updated": "2024-11-19T15:27:31+03:00", "error": null, "error_code": null, "progress": 100, "result": { "errors_by_sku": [ … ], "errors_count": 2, "total_entities_count": 10 }, "status": "error" }
Anfrage
Importiert Artikel aus einer JSON-Datei über die angegebene URL in den Shop. Weitere Informationen zum Import aus einer JSON-Datei finden Sie in der Dokumentation.
Sicherheit
basicAuth
Pfad
Bodyapplication/jsonProjekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.
Beispiel: 44056
Ein Fixwert, der den Vorgangstyp für den Artikelimport festlegt.
Wert"import_items"
Die URL einer Datei mit Daten im JSON-Format. Die Datei sollte auf einem öffentlich zugänglichen Speicherdienst gehostet sein. Die Dateivorlage steht im Kundenportal unter Store > Virtuelle Gegenstände > Katalog verwalten > Artikel importieren (JSON) zum Download bereit.
Beispiel: "https://my-bucket.s3.amazonaws.com/items.json"
- https://connector.xsolla.com/v1/projects/{project_id}/import/from_external_file
- Mock serverhttps://xsolla.redocly.app/_mock/de/api/catalog/v1/projects/{project_id}/import/from_external_file
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
-u <username>:<password> \
https://connector.xsolla.com/v1/projects/44056/import/from_external_file \
-H 'Content-Type: application/json' \
-d '{
"connector_external_id": "import_items",
"file_url": "https://my-bucket.s3.amazonaws.com/items.json",
"mode": "create"
}'Antwort
application/json
{ "import_id": "af9f3638a16e11ef880da2cd677d2d24" }