Xsolla-logo

Katalogsonderangebot erstellenServer-sideAdmin

post/v2/project/{project_id}/admin/unique_catalog_offer

Erstellt ein Katalogsonderangebot.

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
external_id
required
string
Default: "coupon_external_id"

Eindeutige Werbeaktions-ID. Die external_id darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.

required
object
Default: {"de-DE":"Gutscheintitel","en-US":"Coupon title"}

Name der Werbeaktion. Sollte Schlüssel-Wert-Paare enthalten, wobei der Schlüssel ein Gebietsschema im Format "^[a–z]{2}-[A–Z]{2}$" und der Wert ein String ist.

property name*
additional property
string
date_end
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Datum, an dem Ihre Werbeaktion endet. Möglich ist null. Wenn für date_end der Wert null festgelegt ist, läuft die Werbeaktion zeitlich unbegrenzt.

date_start
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Datum, an dem Ihre Werbeaktion beginnt.

items
Array of strings

Eine Liste der Artikel-SKU, die nach Inanspruchnahme des Katalogsonderangebots verfügbar sind.

redeem_code_limit
integer or null
Default: 10

Anzahl der Einlösungen pro Code.

redeem_total_limit
integer or null
Default: 10

Begrenzt die Gesamtzahl der Gutscheine.

redeem_user_limit
integer or null
Default: 10

Begrenzt, wie oft ein einzelner Benutzer Gutscheine einlösen darf.

Responses
201

Katalogsonderangebot wurde erfolgreich erstellt.

401

Basisauthentifizierung nicht bestanden oder falsch. Prüfen Sie die Anmeldedaten und vergewissern Sie sich, dass Sie die Basisauthentifizierung verwenden.

422

Ungültige Anfrage.

Request samples
application/json
{
  • "date_end": "2020-04-25T18:16:00+05:00",
  • "date_start": "2020-04-15T18:16:00+05:00",
  • "external_id": "offer_external_id",
  • "items": "elven_sword elven_boots",
  • "name": {
    },
  • "redeem_code_limit": 1,
  • "redeem_total_limit": 100,
  • "redeem_user_limit": 1
}
Response samples
application/json
{
  • "external_id": "coupon_external_id"
}