wiki:Geonol/API_REST/autocomplete_category.json

categories.json

Cette URL est un service web renvoie les catégories d'un organisme.

L'API de cet autocompleter est compatible avec celle de l'autocompleter de jquery-ui (http://jqueryui.com/demos/autocomplete).

La requête est faite par l'URL : http://annuaire.comarquage.fr/rest/autocomplete_category.json, avec la possibilité de fournir des paramètres en query string.

La réponse est au format JSON.

Paramètres de la requête

  • category (str, multiple) : catégorie de l'organisme. La recherche est faite sur l'union de toutes les catégories fournies, le cas échéant.
  • category_tag (str, multiple) : tag de la catégorie de l'organisme. Les catégories pouvant être taggées, ce paramètre permet de rechercher tous les organismes dont la catégorie est taggée par la valeur spécifiée. La recherche est faite sur l'union de tous les tags de catégories fournis, le cas échéant.
  • jsonp (str) : nom de la fonction javascript retournée pour l'utilisation en AJAX depuis un autre domaine. (http://en.wikipedia.org/wiki/JSONP)
  • limit (int, default=10, min=1, max=100) : nombre maximum d'éléments renvoyés
  • term (str) : terme recherché. Les accents sont enlevés.

Tous les paramètres sont optionnels et peuvent être combinés.

Les paramètres doivent être des chaînes de caractères « url-encodées ».

Réponse

La réponse est une liste dont chaque élément est un objet comportant ces clés : [value, label, count].

  • value est un identifiant unique
  • label est une string lisible par un humain
  • count représente le nombre d'organismes trouvés si l'on choisit ce critère de recherche

Exemples de requêtes

Last modified 7 years ago Last modified on Nov 8, 2010, 4:36:19 PM