Fiche de révision : Interfaces de programmation d'applications

📋 Plan du Cours

1. Principes des API
2. API Base Adresse Nationale
3. Requête et réponse JSON
4. Implémentation en Python

📖 1. Principes des API

🔑 Notions clés & Définitions

• Interface de programmation d’applications : Ensemble de classes, fonctions et constantes grâce auquel un programme fournisseur met des fonctionnalités à disposition de programmes consommateurs.

📝 Points essentiels

📌 Le programme fournisseur définit la manière dont les fonctionnalités sont mises à disposition des consommateurs et peut imposer des contraintes d’accès à l’API.

💡 Astuce mémo

Programme fournisseur → fonctionnalités accessibles aux programmes consommateurs

📖 2. API Base Adresse Nationale

🔑 Notions clés & Définitions

• Base Adresse Nationale : API gratuite du gouvernement français qui permet d’obtenir des informations à partir d’une adresse postale.

📝 Points essentiels

• L’API Base Adresse Nationale peut fournir des informations sur l’adresse postale du lycée Louis Armand.

💡 Astuce mémo

Une adresse postale transformée en point géographique

📖 3. Requête et réponse JSON

🔑 Notions clés & Définitions

• JSON : Format de données textuelles utilisé pour représenter la réponse de l’API.

★ À maîtriser

• Pour interroger l’API, il faut envoyer une requête GET à l’URL https://api-adresse.data.gouv.fr/search/?q=173-boulevard-de-strasbourg&postcode=94130.

Compléments

• L’adresse postale interrogée est indiquée dans l’URL de la requête, notamment avec la valeur q=173-boulevard-de-strasbourg et le filtre postcode=94130.

• La réponse JSON contient notamment les champs suivants:

  • features
  • geometry
  • coordinates
  • properties
  • label
  • postcode
  • city
  • context

💡 Astuce mémo

URL de requête ≠ réponse JSON

📖 4. Implémentation en Python

📝 Points essentiels

• 🔄 L’interrogation Python se déroule ainsi:

  1. Importer requests
  2. Envoyer la requête avec requests.get(url)
  3. Convertir la réponse avec reponse.json()

• La fonction get du module requests envoie une requête GET à l’URL spécifiée et récupère la réponse.

• La commande reponse.json() extrait les données encodées en JSON et permet de les traiter comme un dictionnaire Python.

💡 Astuce mémo

importer → demander → convertir