Aujourd'hui nous allons faier parler des nombres. Et oui, je le transforme en numérologue dans cet article, ou presque.

La problématique :

En fait, ce n'est pas trop une problématique, mais plutôt une recherche d'informations amusante sur les nombres et les chiffres.
L'API est super facile à utiliser, ce ne sont uniquement des URL, sans paramètres (en fait, une réécriture d'URL est définie dans le service). Toute la documentation est disponible à l'adresse http://numbersapi.com

Le service interrogé : http://numbersapi.com

Des nombres, oui, mais pour m'apporter quoi ? Cette question fût la première question que je me suis posée en prenant connaissance de cette API. En fait, on va y trouver des informations à double niveau :

  • Le type d'informations attendues (remarquons que ces paramètres sont anglophones) qui est facultatif :
    • trivia : Valeur par défaut (donc optionnel) : Retourne une donnée triviale
    • math : retourne une information relative aux mathématiques
    • date : retourne une information relative à une date
    • year : retourne une information relative à une année (la valeur saisie est interprétée comme une date)
  • Le nombre en lui même que l'on souhaite interroger

Construction de la requête : la requête à lancer sur le serveur est de la forme :
http://numbersapi.com/number/type
Ex : http://numbersapi.com/42

Il est à noter que chacune des requêtes que vous lancez sur le serveurs, vous renvoie UNE réponse parmi plusieurs. Si vous lancez deux fois de suite la même requête http, les deux réponses retournées pourront être totalement différentes. De ce fait, vous n'avez pas besoin de gérer les répétitions des réponses.

Le résultat

Que dit-on de 42 ?