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

Type de récompense quotidienne définissant les moments où l'utilisateur peut la réclamer.

Enum:	Description
calendar_hard	Débloque la récompense de l'étape suivante toutes les 24 heures. Toute récompense non réclamée est définitivement perdue dès que l'étape suivante devient disponible.
rolling_skippable	Débloque la récompense de l’étape suivante toutes les 24 heures à partir de `date_start`. La progression est séquentielle : une nouvelle récompense ne se débloque que lorsque la précédente a été réclamée. Si un utilisateur saute un ou plusieurs jours, il reprend là où il s’est arrêté ; les jours manqués ne génèrent pas de récompenses supplémentaires.
rolling_unskippable	Débloque la récompense de l’étape suivante toutes les 24 heures à partir de `date_start`. La progression est séquentielle : une nouvelle récompense ne se débloque que lorsque la précédente a été réclamée. Toutefois, si un utilisateur saute un jour, sa progression est réinitialisée et il doit recommencer à partir de la première étape.

is_recurrent

boolean

Default: false

Détermine si la récompense quotidienne est récurrente. Si true, elle est automatiquement réinitialisée après la date de fin. Le calendrier suivant start_date et end_date est basé sur le nombre d'étapes de la récompense quotidienne et l'heure définie initialement sur 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
}