# Liste der Spiele im Besitz des Nutzers abrufen

Ruft eine Liste der Spiele ab, die der Nutzer besitzt. Als Antwort enthält man ein Array von Spielen, die ein bestimmter Nutzer besitzt.


Achtung
Bei 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.





  Hinweis
    Dieser API-Aufruf gibt generische Katalogdaten zurück, wenn er ohne Autorisierung verwendet wird. Verwenden Sie die Autorisierung, um personalisierte Nutzerdaten abzurufen, wie z. B. mit dem Artikel verknüpfte Limits und Werbeaktionen. Dazu müssen Sie den Benutzer-JWT im Authorization-Header übermitteln. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit für diesen Aufruf.

Endpoint: GET /v2/project/{project_id}/entitlement
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt sowie in der Adressleiste des Browsers, wenn Sie im Kundenportal ein Projekt geöffnet haben. Die URL hat das folgende Format: https://publisher.xsolla.com//projects/.
    Example: 44056

## Query parameters:

  - `limit` (integer)
    Begrenzung der Elementanzahl auf der Seite.
    Example: 50

  - `offset` (integer)
    Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0).

  - `sandbox` (integer)
    Welche Arten von Berechtigungen zurückgegeben werden sollen. Ist der Parameter auf 1 gesetzt, werden nur die Berechtigungen zurückgegeben, die der Nutzer in der Testumgebung erhalten hat. Falls der Parameter nicht übermittelt wird oder auf 0 gesetzt ist, werden nur die Berechtigungen zurückgegeben, die der Nutzer im Live-Modus erhalten hat.

  - `additional_fields[]` (array)
    Die Liste der zusätzlichen Felder. Diese Felder sind in der Antwort enthalten, sofern Sie diese in der Anfrage senden. Verfügbare Felder: attributes.

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Dient als Indikator dafür, dass weitere Seiten vorhanden sind.

  - `total_items_count` (integer)
    Gesamtzahl der Artikel im System.

  - `items` (array)

  - `items.name` (string)
    Name des Spielpakets.

  - `items.description` (string)
    Beschreibung des Spielpakets.

  - `items.project_id` (integer)
    Projekt-ID. Dieser Parameter wird im [Kundenportal](https://publisher.xsolla.com/) neben dem Projektnamen angezeigt.

  - `items.game_sku` (string)
    Eindeutige Schlüsselpaket-ID.

  - `items.drm` (string)
    Eindeutige DRM-ID.
    Enum: "steam", "playstation", "xbox", "uplay", "origin", "drmfree", "gog", "epicgames", "nintendo_eshop", "discord_game_store", "oculus", "rockstar", "viveport", "stadia"

  - `items.image_url` (string)
    Bild-URL. Damit das Bild im Zahlungsportal korrekt angezeigt und schnell geladen wird, beachten Sie bitte unsere Richtlinien für Bilder und URLs:Unterstützte Formate: WebP (empfohlen), PNG, JPG.Dateigröße: ≤ 50 kB (für WebP) oder ≤ 150 kB (für PNG und JPG).Bildgröße: 280 x 280 px.Farbraum: sRGB.Protokoll: HTTPS mit langlebigem Caching für versionierte URLs.

  - `items.is_pre_order` (boolean)
    Ob das Spiel vorbestellt werden kann oder nicht.

  - `items.attributes` (array)
    Liste der Attribute und ihrer Werte, die dem Spiel zugeordnet sind.

Achtung: Dieser Teil der Antwort ist nur verfügbar, wenn Sie den Abfrageparameter additional_fields[]=attributes senden.

  - `items.attributes.external_id` (string)
    Eindeutige Attribut-ID. Die external_id darf nur lateinische Klein- und Großbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten.

  - `items.attributes.name` (string)
    Name des Attributs.
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    Eindeutige Wert-ID für ein Attribut. Die external_id darf nur lateinische Kleinbuchstaben, alphanumerische Zeichen, Binde- und Unterstriche enthalten.

  - `items.attributes.values.value` (string)
    Wert des Attributs.
    Example: "Strategy"

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"