Berechtigung erteilen (Admin)

Digital Distribution Hub API

In-Game Store 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

post

Berechtigung erteilen (Admin)

post

Berechtigung entziehen (Admin)

get

Liste der Spiele im Besitz des Benutzers abrufen

post

Spielcode durch Client einlösen

Administrator

WERBEAKTIONEN

Allgemeines

Gutscheine

Promocodes

Katalogsonderangebote

Rabatte

Prämien

VIRTUELLE GEGENSTÄNDE UND WÄHRUNG

Administrator

Katalog

Virtuelle Zahlung

NFT-ARTIKEL

Administrator

Katalog

LIMITS

Verwaltung

BELOHNUNGSKETTEN UND WERTPUNKTE

Administrator

Client

Clans-Client

UPSELL

Administrator

Client

CONNECTOR

Administrator

Pay Station API

Subscriptions API

Webhooks

Berechtigung erteilen (Admin)Server-sideAdmin

post/v2/project/{project_id}/admin/entitlement/grant

Erteilt dem Benutzer eine Berechtigung.

Achtung

Es können nur Spielcodes oder Spiele für DRM-freie Plattformen gewährt werden.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.

Example: 44056

Request Body schema: application/json

user_external_id

required

string

Eindeutige Benutzerkennung.

required

object

Objekt mit Spieleigenschaften.

sku

required

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

Eindeutige Schlüsselpaket-ID.

required

object

Objekt mit DRM-Eigenschaften.

sku

required

string

Eindeutige DRM-ID.

Enum: "steam" "playstation" "xbox" "uplay" "origin" "drmfree" "gog" "epicgames" "nintendo_eshop" "discord_game_store" "oculus" "rockstar" "viveport" "stadia"

mode

required

string

Welche Art von Berechtigungen erteilt werden soll. Ist der Parameter auf sandbox gesetzt wird dem Benutzer in der Testumgebung die Berechtigung erteilt. Ist der Parameter auf default gesetzt, wird die Berechtigung dem Benutzer im Live-Modus erteilt.

Enum: "default" "sandbox"

code

string or null

Spielcode des Spiels.

user_country

string or null

Land des Benutzers.

Responses

200

Die Berechtigung wurde erteilt.

403

Autorisierungs-Header nicht gesendet.

404

Spielcode nicht gefunden. Prüfen Sie, ob code und project_id korrekt sind.

422

Ungültige Anfrage.

Request samples

application/json

{"code": "AAAA-BBBB-CCCC-DDDD",
"drm": {"sku": "drmfree"
},
"game": {"sku": "game_1"
},
"mode": "default",
"user_country": "US",
"user_external_id": "user-external-id"
}

Response samples

application/json

{"errorCode": 0,
"errorMessage": "Authorization header not sent",
"statusCode": 403
}