Zum Inhalt springen
/
Thema festlegen

Subscriptions API (2.0)

Überblick

  • Version: 2.0
  • Servers: https://api.xsolla.com/merchant/v2/

Diese API-Referenz beschreibt Endpunkte für die Verwaltung von Abonnements, Gutscheinen und Werbeaktionen. Weitere Informationen über Subscriptions finden Sie in der Produktanleitung und in der Begriffserläuterung.

OpenAPI-Beschreibung herunterladen
index.json
index.yaml
Sprachen
Server
Mock server
https://xsolla.redocly.app/_mock/de/api/subscriptions/

Token

Operationen

Abo-Modelle

Operationen

Produkte

Operationen

Subscription management

Operationen

Zahlungen

Operationen

Werbeaktionen

Operationen

Thema anfordern

Anfrage

Ruft die Liste der Projekte des Händlers ab.

Bemerkung

Dieser API-Aufruf enthält nicht den Pfadparameter project_id, Sie müssen also den API-Schlüssel verwenden, der in allen Projekten des Unternehmens gültig ist, um die Autorisierung einzurichten.

Sicherheit
basicAuth
Pfad
merchant_idintegererforderlich

Händler-ID.

promotion_idintegererforderlich

ID der Werbeaktion.

curl -i -X GET \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/de/api/subscriptions/merchants/{merchant_id}/promotions/{promotion_id}/subject'

Antworten

OK.

Bodyapplication/json
digital_contentsobject or null
itemsArray of objects

Array der virtuellen Gegenstände, die bei der Werbeaktion zum Einsatz kommen.

packagesArray of objects or null

Array der Angebotspakete mit virtueller Währung, die bei der Werbeaktion zum Einsatz kommen.

purchaseboolean

Legt fest, ob die Werbeaktion auf den gesamten Einkauf zutrifft.

subscriptionsobject or null

Abo-Modelle oder Produkte, die bei der Werbeaktion zum Einsatz kommen.

idinteger
Antwort
application/json
{
  "digital_contents": null,
  "id": 178,
  "items": [
    { … }
  ],
  "packages": null,
  "purchase": false,
  "subscriptions": null
}

Thema festlegen

Anfrage

Ruft die Liste der Projekte des Händlers ab. Wenn die Aktion schreibgeschützt ist(read_only = true), können Sie die Prämien nicht aktualisieren. Das Subjekt kann folgende Werte annehmen:purchase, oder items, oderpackages.

Bemerkung

Dieser API-Aufruf enthält nicht den Pfadparameter project_id, Sie müssen also den API-Schlüssel verwenden, der in allen Projekten des Unternehmens gültig ist, um die Autorisierung einzurichten.

Sicherheit
basicAuth
Pfad
merchant_idintegererforderlich

Händler-ID.

promotion_idintegererforderlich

ID der Werbeaktion.

Bodyapplication/jsonerforderlich
digital_contentsobject or null
itemsArray of objects

Array der virtuellen Gegenstände, die bei der Werbeaktion zum Einsatz kommen.

packagesArray of objects or null

Array der Angebotspakete mit virtueller Währung, die bei der Werbeaktion zum Einsatz kommen.

purchaseboolean

Legt fest, ob die Werbeaktion auf den gesamten Einkauf zutrifft.

subscriptionsobject or null

Abo-Modelle oder Produkte, die bei der Werbeaktion zum Einsatz kommen.

curl -i -X PUT \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/de/api/subscriptions/merchants/{merchant_id}/promotions/{promotion_id}/subject' \
  -H 'Content-Type: application/json' \
  -d '{
    "digital_contents": null,
    "items": [
      {
        "sku": "1234"
      }
    ],
    "packages": null,
    "purchase": false,
    "subscriptions": null
  }'

Antworten

No Content (Kein Inhalt).

Werbeaktion zu-/abschalten

Anfrage

Schaltet den Status einer Aktion von enabled auf disabled um und umgekehrt.

Bemerkung

Dieser API-Aufruf enthält nicht den Pfadparameter project_id, Sie müssen also den API-Schlüssel verwenden, der in allen Projekten des Unternehmens gültig ist, um die Autorisierung einzurichten.

Sicherheit
basicAuth
Pfad
merchant_idintegererforderlich

Händler-ID.

promotion_idintegererforderlich

ID der Werbeaktion.

curl -i -X PUT \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/de/api/subscriptions/merchants/{merchant_id}/promotions/{promotion_id}/toggle'

Antworten

No Content (Kein Inhalt).

Gutscheine

Operationen

Subscription management

Operationen