La création d'un événement sur cette route permet dans une même requête de:
- créer un événement
- définir son statut au sein de l'agenda
- lui associer des données personnalisées, définies au préalable dans le modèle de l'agenda
Important: Une authentification est nécessaire pour cette opération.
L'ajout d'un nouvel événement sur un agenda se fait par le biais d'une requête post à la route suivante:
/v2/agendas/{agendaUid}/events
Paramètres
Header
- access-token: Requis; un jeton valide (voir la section authentification)
- lang: Optionnel; langue utilisée lorsque les contenus des champs multilingues (titre, descriptifs, conditions) sont fournis en textes simples plutôt qu'en objet de textes répartis par clés. Ex: `{ title: 'Un titre en français' }` vs `{ title: { fr: 'Un titre en français' } }`.
Body
Les données définissant l'événement doivent être placées sous une clé `data` en corps de requête.
Contenu du champ 'data'
Les données nécessaires à la création d'un événement, son état au sein de l'agenda et ses données personnalisées doivent toutes être spécifiées dans le corps de requête sous la clé 'data'.
Les champs standards
Les champs standards sont détaillés dans une section dédiée
Les champs spécifiques à un agenda
Les champs spécifiant le statut de l'événement au sein de l'agenda sont
- state: entier - l'état de l'événement à l'ajout. Les valeurs possibles sont
- 0: événement non publié, à contrôler
- 1: événement non publié, controlé
- 2: événement publié (valeur par défaut)
- featured: booléen ( défaut: false ) - vrai quand l'événement doit apparaître en tête de liste ( en une )
Les champs additionnels
La structure de ces champs est détaillée dans la section configuration d'un agenda