Copy

[Isogeo] Modifications de l'API pour la version 2.11

Ce mail ne s'affiche pas correctement ? Cliquez ici.
Bonjour,

Nous prévoyons quelques modifications mineures de l'API pour la prochaine version (2.11.0) qui seras mise en production à la fin du mois de mars. Ces modifications ne devraient pas entraîner de maintenance de votre part, mais faciliter l'utilisation de notre API en nécessitant moins d'appels.

En bonne information, voici le détail des changements.

La sous-ressource keywords n'est plus remontée

En version 2.10 les métadonnées remontées par l'API contiennent la sous-ressource keywords avec le détail des mots-clés affectés à chaque ressource. 

En version 2.11 ce n'est plus le cas : les mots-clés affectés à chaque ressource sont déjà disponibles dans la sous-ressource _tags et la sous-ressource keywords n'est donc plus remontée.

Nouveau paramètre global _include

En version 2.10 il est nécessaire de faire des appels supplémentaires à l'API si l'on veut récupérer les sous-ressources qui ne sont pas remontées par défaut. Exemples : conditions, limitations, links ou feature-attributes...

En version 2.11 il est possible de demander à l'API de remonter directement certaines sous-ressources lors du premier appel en ajoutant le paramètre _include. Sa valeur est la liste des sous-ressources que l'on souhaite voir remonter.

La liste des sous-ressources disponibles pour l'entité resource est :
  • coordinate-system,
  • conditions,
  • contacts,
  • creator,
  • events,
  • feature-attributes,
  • keywords,
  • limitations,
  • links,
  • et specifications.
Le paramètre est pris en compte sur les routes GET /resources/search et GET /resources/{:id}. Exemple : /resources/search?q=test&_include=links,coordinate-system.
Consulter la documentation (beta) de l'API
Julien Moura
Chef de projets & community manager
Plateforme
Plateforme
Site internet
Site internet
Blog
Blog
LinkedIn
LinkedIn
Viadeo
Viadeo
Twitter
Twitter
Google Plus
Google Plus
Copyright © 2015 Isogeo, Tous droits réservés.

Email Marketing Powered by Mailchimp