Tägliche Belohnung aktualisieren

project_id required	integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt. Example: 44056
daily_chain_id required	integer ID der täglichen Belohnung. Example: 101

Request Body schema: application/json

One of:

Grundlegende Eigenschaften für tägliche Belohnungen vom Typ calendar_hard.

required

(two-letter (object or null)) or (five-letter (object or null))

Objekt mit Lokalisierungen für Artikelnamen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Optionen angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der Dokumentation.

One of:

Sprachencodes bestehend aus zwei Kleinbuchstaben.

ar	string or null Arabisch
bg	string or null Bulgarisch
cn	string or null Chinesisch (vereinfacht)
cs	string or null Tschechisch
de	string or null Deutsch
en	string or null Englisch
es	string or null Spanisch (Spanien)
fr	string or null Französisch
he	string or null Hebräisch
id	string or null Indonesisch
it	string or null Italienisch
ja	string or null Japanisch
km	string or null Khmer
ko	string or null Koreanisch
lo	string or null Laotisch
my	string or null Birmanisch
ne	string or null Nepalesisch
ph	string or null Filipino
pl	string or null Polnisch
pt	string or null Portugiesisch
ro	string or null Rumänisch
ru	string or null Russisch
th	string or null Thai
tr	string or null Türkisch
tw	string or null Chinesisch (traditionell)
vi	string or null Vietnamesisch

date_start

required

string <date-time>

Datum, an dem die tägliche Belohnung beginnt.

required

Array of objects

Array

step_number

required

integer >= 1

Schrittnummer.

required

Array of objects non-empty

Array (non-empty)

sku required	string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$ Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.
quantity required	integer >= 1 Menge der täglichen Belohnung für diese SKU

step_id

integer or null >= 1

Eindeutige Kennung des Belohnungsschritts. Geben Sie die ID während der Aktualisierung an, damit der Nutzerfortschritt für diesen Schritt nicht verloren geht.

is_enabled

required

boolean

type

required

string

Belohnungstyp, der festlegt, wann Nutzer Belohnungen beanspruchen können.

Enum:	Description
calendar_hard	Schaltet alle 24 Stunden die nächste Schrittbelohnung frei. Nicht beanspruchte Schrittbelohnungen verfallen endgültig, sobald die nächste Schrittbelohnung verfügbar wird.
rolling_skippable	Schaltet alle 24 Stunden die nächste Schrittbelohnung basierend auf dem `date_start` frei. Der Fortschritt erfolgt schrittweise: Eine neue Belohnung wird erst freigeschaltet, wenn die vorherige beansprucht wurde. Wenn ein Nutzer einen oder mehrere Tage auslässt, setzt er an der Stelle fort, an der er aufgehört hat; für ausgelassene Tage werden keine mehrfachen Belohnungen vergeben.
rolling_unskippable	Schaltet alle 24 Stunden die nächste Schrittbelohnung basierend auf dem `date_start` frei. Der Fortschritt erfolgt schrittweise: Eine neue Belohnung wird erst freigeschaltet, wenn die vorherige beansprucht wurde. Wenn ein Nutzer jedoch einen Tag auslässt, wird der Fortschritt zurückgesetzt, und der Nutzer muss wieder beim ersten Schritt beginnen.

is_recurrent

boolean

Default: false

Ob die tägliche Belohnung wiederkehrend ist. Ist true festgelegt, wird die tägliche Belohnung nach dem Enddatum automatisch zurückgesetzt. Das nächste start_date und end_date basiert auf der Anzahl der Belohnungsschritte und dem eingestellten Anfangszeitpunkt (start_date).

(two-letter (object or null)) or (five-letter (object or null))

Objekt mit Lokalisierungen für Artikelbeschreibungen. Werte können in zwei Formaten angegeben werden: Sprachencode bestehend aus zwei Kleinbuchstaben (z. B. en) oder fünfstelliger Gebietsschemacode (z. B. en-US). Beide Formate werden als Eingabe akzeptiert, als Antwort werden jedoch stets zweistellige Sprachencodes in Kleinbuchstaben zurückgegeben. Wenn für dieselbe Sprache beide Optionen angegeben sind (z. B. en und en-US), wird der zuletzt angegebene Wert gespeichert. Die vollständige Liste der unterstützten Sprachen finden Sie in der Dokumentation.

One of:

Sprachencodes bestehend aus zwei Kleinbuchstaben.

ar	string or null Arabisch
bg	string or null Bulgarisch
cn	string or null Chinesisch (vereinfacht)
cs	string or null Tschechisch
de	string or null Deutsch
en	string or null Englisch
es	string or null Spanisch (Spanien)
fr	string or null Französisch
he	string or null Hebräisch
id	string or null Indonesisch
it	string or null Italienisch
ja	string or null Japanisch
km	string or null Khmer
ko	string or null Koreanisch
lo	string or null Laotisch
my	string or null Birmanisch
ne	string or null Nepalesisch
ph	string or null Filipino
pl	string or null Polnisch
pt	string or null Portugiesisch
ro	string or null Rumänisch
ru	string or null Russisch
th	string or null Thai
tr	string or null Türkisch
tw	string or null Chinesisch (traditionell)
vi	string or null Vietnamesisch

integer

Eindeutige ID der täglichen Belohnung.

order

integer

Definiert die Anordnungsreihenfolge.

Responses

204

Tägliche Belohnung wurde erfolgreich aktualisiert.

401

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

404

Tägliche Belohnung wurde nicht gefunden.

422

Fehler bei der Konfiguration der täglichen Belohnung.

Request samples

application/json

{"date_start": "2023-04-15T18:16:00+05:00",
"description": {"en": "Updated daily reward description"
},
"is_enabled": true,
"name": {"en": "Updated daily reward",
"ru": "Обновленная ежедневная награда"
},
"order": 4,
"steps": [{"items": [{"quantity": 1,
"sku": "vg_enabled_shown_in_store_1"
}
],
"step_number": 1
},
{"items": [{"quantity": 1,
"sku": "vg_enabled_shown_in_store_2"
}
],
"step_number": 2
},
{"items": [{"quantity": 1,
"sku": "vg_not_shown_in_store"
}
],
"step_id": 10,
"step_number": 3
},
{"items": [{"quantity": 1,
"sku": "bundle_enabled_shown_in_store_with_2_enabled_shown_in_store_vg"
}
],
"step_id": 8,
"step_number": 4
},
{"items": [{"quantity": 1,
"sku": "vcp_enabled_shown_in_store_1_of_10_vc_enabled_shown_in_store_1"
}
],
"step_number": 5
}
],
"type": "calendar_hard"
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}