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

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

Les paramètres suivants sont à placer dans le corps ( body ) de la requête.

  • access_token: votre token d'accès.
  • nonce: un entier unique et aléatoire
  • data: les données de l'événement. Voir les sections suivantes pour le détail.

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écifiants 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