Authentification

Placez la clé publique du compte lié dans un paramètre query "key".

Alternativement, placez les valeurs suivante dans l'entête de votre requête:

  • access-token: votre token d'accès
  • nonce: un entier à utilisation unique

Lister les lieux d'un agenda

Lire les lieux liés à un agenda se fait avec une requête get sur la route suivante:

/v2/agendas/{agendaUid}/locations

Les résultats sont paginés.

Paramètres

Les paramètres suivant peuvent être précisés:

  • limit: Facultatif. Un entier déterminant le nombre de lieux maximum contenus dans la réponse
  • detailed: Facultatif. Lorsque ce paramètre est présent, la réponse comprend les données de tous les champs de chaque lieu.
  • after: Facultatif. Voir la section suivante.
  • search: Facultatif. Recherche syntaxique permettant de filtrer le contenu

Réponse

La réponse contient les clés suivantes:

  • locations: plage de lieux correspondants aux critères de la requête
  • total: total des lieux correspondant à la requête
  • after: valeur à préciser en paramêtre "query" pour récupérer la plage de lieux suivante

Récupérer le contenu d'un lieu

La lecture d'un lieu sur un agenda se fait avec une requête get sur la route suivante:

/v2/agendas/{agendaUid}/locations/{locationUid}

Faire une requête head sur la même route renvoie un code 200 si le lieu existe, 404 sinon.

Réponse

La réponse contient les données du lieu

Identifiant externe

L'identifiant externe peut également servir pour récuperer le détail d'un lieu. La route prend la forme suivante:

/v2/agendas/{agendaUid}/locations/ext/{extId}