• API ET JSON

    API ? Qu'est-ce que c'est

    Selon la définition de Wikipédia

    En informatique, une interface de programmation d’application ou interface de programmation applicative (souvent désignée par le terme API pour Application Programming Interface) est un ensemble normalisé de classes, de méthodes, de fonctions et de constantes qui sert de façade par laquelle un logiciel offre des services à d'autres logiciels. Elle est offerte par une bibliothèque logicielle ou un service web, le plus souvent accompagnée d'une description qui spécifie comment des programmes consommateurs peuvent se servir des fonctionnalités du programme fournisseur. De manière plus générale, on parle d'API à partir du moment où une entité informatique cherche à agir avec ou sur un système tiers, et que cette interaction se fait de manière normalisée en respectant les contraintes d'accès définies par le système tiers. On dit que le système tiers « expose une API. » À ce titre, des choses aussi diverses que la signature d'une fonction, une URL, un RPC… sont parfois considérés comme des API (ou micro-API) à part entière.

    En d'autre termes, l'API est un moyen simple de pouvoir récupérer des données depuis un site tiers. Ou encore, de fournir des données depuis votre site. (Voir le paragraphe sur le CrossDomain). Dans le principe, on va envoyer une requête vers le site de l'API avec certains critères et récupérer les données correspondant à la requête. La plupart du temps, ces données vous sont renvoyées au format JSON (dont je parle au paragraphe suivant).

    Plus bas dans cette page, vous trouverez une liste d'API utiles et accessibles gratuitement . Pour chacune d'elle, je ferai une page d'exemple avec un tuto.

    Le format JSON, c'est quoi ?

    JSON (JavaScript Objet Notation) est un langage léger d’échange de données textuelles. Pour les ordinateurs, ce format se génère et s’analyse facilement. Pour les humains, il est pratique à écrire et à lire grâce à une syntaxe simple et à une structure en arborescence. JSON permet de représenter des données structurées (comme XML par exemple).

    Vous pouvez voir ci-contre un résultat au format JSON obtenu à la suite d'une requête faite à l'API Rest Countries. Ma requête portait sur la Suisse (code ch).

    On retrouve notamment dans les résultats: la capitale, la population, les langues, les pays limitrophes, l'indicatif téléphonique, le drapeau etc.

    La structure de ce type de fichier est relativement simple et l'on voit assez facilement à quoi correspondent les différentes données. (Pour certaines API, l'anglais ne sera pas de trop. C'est le cas ci-contre)

    Je vous montrerai dans les différents tutos comment effectuer la requête, comment récupérer le fichier JSON et surtout comment accéder et comment exploiter ces données.
    De la même manière, j'écrirai un article pour vous apprendre à créer votre propre fichier JSON

    Liste d'APIs Pratiques

    Voici ci-dessous une liste d'APIs qui peuvent s'avérer utiles pour vos blogs. La colonne Token indique s'il vous faut une clé pour accéder aux données (API Key). Dans ce cas, cela nécessite une inscription sur le site officiel.

    Producteur : Etalab Le registre public des associations #Description
    APIObjetExempleToken
    REST Countries Permet d'avoir des informations sur les pays, telles que la capitale, le code du pays, la monnaie, le continent, la population, etc...  Exemple Rest Countries Non
    OpenWeatherMap Site collectant des données de plus de 40 000 stations météo dans le monde. Vous pouvez récupérer les données (météo du jour/semaine, vents, pression atmosphérique, nuages, précipitations, etc...) via le nom d'une ville ou ses coordonnées GPS.   Oui
    TheMovieDB C'est une sorte d'Allocine mais contenant plus de données. Très complète, l'API vous permet de rechercher des films ou des séries TV, des acteurs   Oui
    API GEO Grâce à elle vous pouvez notamment : Rechercher des communes par nom, code postal ou coordonnées géographiques, Connaître les groupements auxquels appartient une commune, ainsi que leurs compétences (bientôt), Savoir si une parcelle appartient à certains zonages (appellations d'origine, quartiers prioritaires…) (bientôt)   Non
    Base Adresse Nationale La Base Adresse Nationale est une base de données qui a pour but de référencer l'intégralité des adresses du territoire français.   Non
    API SIRENE API Sirene donne accès aux informations concernant les entreprises et les établissements immatriculés au répertoire interadministratif Sirene depuis sa création en 1973, y compris les unités fermées. La recherche peut être unitaire, multicritère, phonétique et porter sur les données courantes et historisées.   Oui
    API Carto API de récupération des communes associées à un code postal donné   Non
    API La Bonne Boite La Bonne Boite cible les entreprises ayant des perspectives d'embauche élevées et permet d’être plus efficace dans l’envoi de candidatures spontanées. Ce ciblage est obtenu par l'analyse de millions de recrutements sur toutes les entreprises françaises. L’API La Bonne Boite permet de récupérer la liste des entreprises classées par potentiel d'embauche pour un métier (code ROME) et/ou activité (code NAF) donné, pour une localisation donnée.   Oui
    Annuaire des établissements publics de l'administration Cette API recense plus de 60 000 guichets publics locaux (mairies, organismes sociaux, services de l'état, etc.). Elle fournit leurs coordonnées (adresses, téléphones, site internet, horaires d'ouverture, coordonnées de géolocalisation)   Non
    Trèfle L’API Simulateur de financement restitue les financements possibles pour une formation choisie et un profil d’utilisateur déterminé ainsi que la rémunération pendant cette formation. L’API est accessible pour les demandeurs d’emploi et les salariés du secteur privé sur l’ensemble du territoire et permet une simulation de financement et de rémunération.   Oui
    Répertoire National des Associations L’API Répertoire des Associations permet d'interroger le répertoire des associations françaises. Récupérer les informations d'une association Non

    Exemples

    Affichage du cours des actions - Exemple de la FDJ

    Récupérer les informations d'une association