Créer une récompense quotidienne

Conteneur objet contenant les localisations du nom de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la documentation pour la liste complète des langues prises en charge.

One of:

Codes de langue à deux lettres minuscules.

ar	string or null Arabe
bg	string or null Bulgare
cn	string or null Chinois (simplifié)
cs	string or null Tchèque
de	string or null Allemand
en	string or null Anglais
es	string or null Espagnol (Espagne)
fr	string or null Français
he	string or null Hébreu
id	string or null Indonésien
it	string or null Italien
ja	string or null Japonais
km	string or null Khmer
ko	string or null Coréen
lo	string or null Laotien
my	string or null Birman
ne	string or null Népalais
ph	string or null Philippin
pl	string or null Polonais
pt	string or null Portugais
ro	string or null Roumain
ru	string or null Russe
th	string or null Thaï
tr	string or null Turc
tw	string or null Chinois (traditionnel)
vi	string or null Vietnamien

date_start

required

string <date-time>

Date de début de la récompense quotidienne.

required

Array of objects

Array

step_number

required

integer >= 1

Numéro de l'étape.

required

Array of objects non-empty

Array (non-empty)

sku required	string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$ ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des points, des tirets et des traits bas.
quantity required	integer >= 1 Nombre d'étapes de récompense quotidienne pour cette UGS

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

Conteneur objet contenant les localisations de la description de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la documentation pour la liste complète des langues prises en charge.

One of:

Codes de langue à deux lettres minuscules.

ar	string or null Arabe
bg	string or null Bulgare
cn	string or null Chinois (simplifié)
cs	string or null Tchèque
de	string or null Allemand
en	string or null Anglais
es	string or null Espagnol (Espagne)
fr	string or null Français
he	string or null Hébreu
id	string or null Indonésien
it	string or null Italien
ja	string or null Japonais
km	string or null Khmer
ko	string or null Coréen
lo	string or null Laotien
my	string or null Birman
ne	string or null Népalais
ph	string or null Philippin
pl	string or null Polonais
pt	string or null Portugais
ro	string or null Roumain
ru	string or null Russe
th	string or null Thaï
tr	string or null Turc
tw	string or null Chinois (traditionnel)
vi	string or null Vietnamien

order

integer

Définit l'ordre d'empilement.

Responses

201

Récompense quotidienne créée avec succès.

401

L'authentification de base n'a pas été passée ou est incorrecte. Vérifiez que vous avez utilisé l'authentification de base ou des informations d'identification correctes.

422

Erreurs de configuration de la récompense quotidienne.

Request samples

application/json

{"date_start": "2023-04-15T18:16:00+05:00",
"description": {"en": "New daily reward short description"
},
"is_enabled": true,
"name": {"en": "New daily reward",
"ru": "Новая ежедневная награда"
},
"order": 4,
"steps": [{"items": [{"quantity": 2,
"sku": "vg_enabled_shown_in_store_1"
}
],
"step_number": 1
},
{"items": [{"quantity": 2,
"sku": "bundle_enabled_shown_in_store_with_2_enabled_shown_in_store_vg"
}
],
"step_number": 2
},
{"items": [{"quantity": 2,
"sku": "vcp_enabled_shown_in_store_1_of_10_vc_enabled_shown_in_store_1"
}
],
"step_number": 3
},
{"items": [{"quantity": 1,
"sku": "vg_enabled_shown_in_store_1"
}
],
"step_number": 4
},
{"items": [{"quantity": 1,
"sku": "bundle_enabled_shown_in_store_with_2_enabled_shown_in_store_vg"
}
],
"step_number": 5
},
{"items": [{"quantity": 1,
"sku": "vcp_enabled_shown_in_store_1_of_10_vc_enabled_shown_in_store_1"
}
],
"step_number": 6
}
],
"type": "calendar_hard"
}

Response samples

application/json

{"daily_chain_id": 10
}