API : généralités
Une API[1] défini un ensemble de fonctions unitaires.
Il existe des API dans divers domaines d'application. Ces API définissent des fonctions permettant l'échange de données entre applications, ou à destination d'un utilisateur.
Une API permet de rendre accessible des contenus ou des données issues d'une application, d'une base de données ou d'un système de fichiers. En respectant des protocoles de communication, cette API favorise alors l’interopérabilité entre diverses applications, via un réseau local, ou via internet.
Complément :
Le site https://api.gouv.fr/ répertorie l'ensemble des API en lien avec les administrations.
On peut notamment accéder ici aux API fournissant des données dans le domaine de l'énergie : https://api.gouv.fr/guides/api-energie
Exemple : API Carto, module Codes Postaux
L'API Carto module « codes postaux » permet de connaitre les communes rattachées à un code postal. Sa documentation est consultable ici :
https://api.gouv.fr/documentation/api_carto_codes_postaux
Si l'on souhaite interroge l'API avec le code postal 81000, il suffit de consulter la page internet :
https://apicarto.ign.fr/api/codes-postaux/communes/81000
L'API renvoie alors en réponse le JSON :
[
{"codePostal": "81000",
"codeCommune": "81004",
"nomCommune": "Albi",
"libelleAcheminement": "ALBI"
},
{"codePostal": "81000",
"codeCommune": "81144",
"nomCommune": "Lescure-d'Albigeois",
"libelleAcheminement": "ALBI"
},
{"codePostal": "81000",
"codeCommune": "81285",
"nomCommune": "Sérénac",
"libelleAcheminement": "ALBI"
}
]