Zum Inhalt springen
/
Thema anfordern

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

Belohnungen 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.

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
itemobject

Legt die Belohnung für bestimmte virtuelle Gegenstände fest.

packageobject

Legt die Belohnung für ein virtuelles Währungspaket fest.

purchaseobject

Legt die Belohnung für den gesamten Einkauf fest.

subscriptionobject

Legt die Belohnung für ein Abonnement fest.

curl -i -X PUT \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/de/api/subscriptions/merchants/{merchant_id}/promotions/{promotion_id}/rewards' \
  -H 'Content-Type: application/json' \
  -d '{
    "item": {
      "bonus": [
        {
          "quantity": 2,
          "sku": "1234"
        }
      ],
      "discount": [
        {
          "discount_percent": 5,
          "max_amount": 10,
          "sku": "1234"
        }
      ]
    },
    "package": {
      "bonus_amount": 5,
      "bonus_percent": 5
    },
    "purchase": {
      "discount_percent": 10
    },
    "subscription": {
      "trial_days": 30
    }
  }'

Antworten

No Content (Kein Inhalt).

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).

Gutscheine

Operationen

Subscription management

Operationen