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:

Base properties for calendar_hard daily reward type.

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

Daily reward type that determines when users can claim rewards.

Enum:	Description
calendar_hard	Unlocks the next step reward every 24 hours. Any unclaimed step rewards are permanently lost once the next step reward becomes available.
rolling_skippable	Unlocks the next step reward every 24 hours based on `date_start`. Progression is sequential: a new reward will not unlock until the previous one has been claimed. If a user skips one or more days, they continue from where they left off; missed days do not grant multiple rewards.
rolling_unskippable	Unlocks the next step reward every 24 hours based on `date_start`. Progression is sequential: a new reward will not unlock until the previous one has been claimed. However, if a user skips a day, their progress is reset, and they must start again from the first step.

is_recurrent

boolean

Default: false

Whether the daily reward is recurrent. If true, the daily reward will automatically reset after the end date. The next start_date and end_date schedule is based on the number of daily reward steps and the initial time set on 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
}