Aujourd'hui nous allons regarder de plus près si on peut respirer l'air ou pas
La problématique :
De plus en plus de personnes se plaignent de leur qualité de l'air ambiant. Je vous ai trouvé cette semaine un webservice qui saura répondre à cette question. Attention toutefois, une apnée de plus de quelques minutes peut être néfaste à votre vie.
Le service interrogé
AirVisual est donc un service, à priori suisse, qui vous propose de vous renvoyer des informations sur la qualité de l'air. Son API est bien faite, sa documentation plutôt claire : la page web de la doc est découpée en 3 colonnes :
- L'API présentée hiérarchiquement
- La doc dans la deuxieme colonne
- Des "exemples" en 3e colonne (avec la possibilité de choix du langage parmi cURL, PHP, jQuery, node, go.... Déroutant au départ car on n'a pas l'habitude de cette présentation, je reconnais que c'est très pratique. En revanche, gros bémol à ce service, certains accès ont l'air réservés (abonnement payant ?) mais la doc ne le mentionne pas.
Un paramètre est à placer dans l'URL (la notion de région) que je ne connaissais pas. J'ai du reprendre la doc pour touver cette valeur... en lancant une API ! J'attire aussi l'attention des personnes francophone sur cet sujet : la région ("Grand Est" dans mon cas) se passe dans le paramètre country !
L'appel de l'API se fait donc de cette manière : http://api.airvisual.com/v2/city?city=Nancy&state=Grand%20Est&country=france&key=[VOTRE CLEF API]
Le résultat
Oui je vous entends : "c'est quoi tous ces codes retournés ?". Alors je vous donne tout de suite la réponse : la doc se trouve sur https://api-docs.airvisual.com/#return-codes