[POST] /v2/agendas/{agendaUID}/locations
  • agendaUID est l'identifiant de l'agenda où l'événement doit être créé
  • Une authentification est nécessaire. Voir ici.
  • Les données définissant le lieu sont à placer directement dans le corps de requête, elles sont détaillées ici.
  • La réponse contient le détail du lieu créé sous une clé location

L'encodage:

  1. Il n'y a pas d'image associée au lieu. L'encodage peut être de type 'application/json', auquel cas les données demandées pour la création du lieu peuvent être directement définies dans le corps de la requête
  2. L'encodage peut être de type 'mulipart/form-data'. Les données doivent être encodées en JSON pour être placées dans un champ 'data'. Si une image est à associer au lieu, c'est ce format qui doit être utilisé. L'image doit alors être placé en tant que fichier dans un champ nommé 'image'.

Création par identifiants externes

Il est possible de créer des événements via la route suivante. Cette route est particulièrement utile pour synchroniser une source de donnée disposant de ses propres identifiants de lieux:

[PUT] /v2/agendas/{agendaUID}/locations/ext/{extKey}/{extID}
  • `extKey` est alors le nom de l'identifiant, `extID` sa valeur
  • Si le lieu existe déjà, il sera mis à jour
  • Un lieu peut être associé à plusieurs identifiants externes
  • Un lieu associé à un ou plusieurs identifiants externes garde un identifiant OpenAgenda unique (UID).