11 juin 2015 | Team ISTEX | API , Développement

Normalisation des champs de l’API le 19/06


Chers utilisatrices et utilisateurs,

Comme vous avez pu le constater, les différents champs renvoyés par l’API sont actuellement normalisés dans des formats différents.

Nous retrouvons essentiellement du camelCase :

mais également du snake_case pour les agrégations/facettes :

et certains champs sont même en lowercase :

 

Le snake_case des agrégations/facettes s’explique par le retour du moteur de recherche ElasticSearch. En effet, l’API renvoie jusqu’ici la réponse brute de ce dernier, qui est bel et bien en snake_case.

Dans un souci d’homogénéité des résultats, pour une meilleure lisibilité et facilité d’utilisation, il a été convenu que ces champs devraient être également en camelCase. Ce changement sera effectif lors du prochain rechargement des corpus, à la fin de la semaine prochaine.

Les différents champs concernés sont les suivants :

 

De même, cette normalisation va également impactée le nom des facettes en question. En effet, pour garder une logique, le nom de la facette correspond au nom du champ interrogé, ce qui impliquera que :

Pour toutes suggestions et/ou remarques, n’hésitez pas à nous écrire un commentaire !