Appeler une API REST en Python : urllib et requests

# communes_urllib.py : appeler une API REST avec la seule bibliothèque standard
import json
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import Request, urlopen

API = "https://geo.api.gouv.fr"
parametres = urlencode({"codePostal": "71000", "fields": "nom,code"})
requete = Request(f"{API}/communes?{parametres}", headers={"Accept": "application/json"})

with urlopen(requete, timeout=10) as reponse:
    print(reponse.status, reponse.headers["Content-Type"])
    communes = json.load(reponse)

for commune in communes:
    print(commune["code"], commune["nom"])

try:
    urlopen(f"{API}/communes/99999", timeout=10)
except HTTPError as erreur:
    print("Erreur HTTP", erreur.code)

200 application/json; charset=utf-8
71270 Mâcon
71497 Sancé
71556 Varennes-lès-Mâcon
Erreur HTTP 404

# communes_requests.py : le même appel avec requests
import requests

API = "https://geo.api.gouv.fr"

reponse = requests.get(f"{API}/communes",
                       params={"codePostal": "71000", "fields": "nom,code"}, timeout=10)
reponse.raise_for_status()                  # lève une exception pour un code 4xx ou 5xx
print(reponse.status_code, reponse.url)
for commune in reponse.json():
    print(commune["code"], commune["nom"])

introuvable = requests.get(f"{API}/communes/99999", timeout=10)
print(introuvable.status_code, introuvable.ok)

200 https://geo.api.gouv.fr/communes?codePostal=71000&fields=nom%2Ccode
71270 Mâcon
71497 Sancé
71556 Varennes-lès-Mâcon
404 False

# erreurs_reseau.py : les trois familles d'erreurs d'un appel d'API
import requests


def appeler(url):
    try:
        reponse = requests.get(url, timeout=3)
        reponse.raise_for_status()
    except requests.HTTPError as erreur:
        return f"le serveur a répondu {erreur.response.status_code}"
    except requests.ConnectionError:
        return "connexion impossible (nom inconnu, serveur arrêté, réseau coupé)"
    except requests.Timeout:
        return "pas de réponse dans le délai"
    return f"{reponse.status_code} OK, {len(reponse.content)} octets"


for url in ["https://geo.api.gouv.fr/communes/71270",
            "https://geo.api.gouv.fr/communes/99999",
            "https://api.gsb.example/v1/fiches",
            "http://127.0.0.1:9/"]:
    print(f"{url}\n  -> {appeler(url)}")

https://geo.api.gouv.fr/communes/71270
  -> 200 OK, 159 octets
https://geo.api.gouv.fr/communes/99999
  -> le serveur a répondu 404
https://api.gsb.example/v1/fiches
  -> connexion impossible (nom inconnu, serveur arrêté, réseau coupé)
http://127.0.0.1:9/
  -> connexion impossible (nom inconnu, serveur arrêté, réseau coupé)

# creer_fiche.py : envoyer du JSON avec POST et lire une erreur de validation
import os

import requests

API = os.environ.get("GSB_API", "http://localhost:3000/v1")
entetes = {"Authorization": f"Bearer {os.environ['GSB_JETON']}"}

for mois in ["2026-13", "2026-12"]:
    reponse = requests.post(f"{API}/fiches", json={"mois": mois}, headers=entetes, timeout=5)
    if reponse.status_code == 201:
        print("Créée :", reponse.headers["Location"], reponse.json())
    else:
        probleme = reponse.json()           # erreur au format de la RFC 9457
        print(reponse.status_code, probleme["title"])
        for erreur in probleme.get("erreurs", []):
            print(" -", erreur["champ"], ":", erreur["message"])

sans_jeton = requests.get(f"{API}/fiches", timeout=5)
print(sans_jeton.status_code, sans_jeton.json()["title"])

export GSB_API="http://localhost:3000/v1"     # ton API AppliFrais en local (cours API REST)
export GSB_JETON="demo-jeton-gsb"              # avec ta propre API, le jeton obtenu à la connexion
python creer_fiche.py

422 Données invalides
 - mois : Format attendu : AAAA-MM
Créée : /v1/fiches/69 {'id': 69, 'visiteurId': 7, 'mois': '2026-12', 'etat': 'CR', 'montantValide': None}
401 Authentification requise

# fiches.py : lire toutes les fiches clôturées de l'API GSB, page par page, avec un jeton
import os

import requests

API = os.environ.get("GSB_API", "http://localhost:3000/v1")
JETON = os.environ["GSB_JETON"]               # jamais écrit dans le code

session = requests.Session()                  # réutilise la connexion et les en-têtes
session.headers.update({"Authorization": f"Bearer {JETON}", "Accept": "application/json"})


def toutes_les_fiches(etat):
    """Parcourt toutes les pages de /fiches et renvoie la liste complète."""
    fiches, page = [], 1
    while True:
        reponse = session.get(f"{API}/fiches", params={"etat": etat, "page": page, "limite": 20}, timeout=5)
        reponse.raise_for_status()
        corps = reponse.json()
        fiches.extend(corps["donnees"])
        print(f"page {page}/{corps['pagination']['pages']} : {len(corps['donnees'])} fiches")
        if page >= corps["pagination"]["pages"]:
            return fiches
        page += 1


cloturees = toutes_les_fiches("CL")
print(len(cloturees), "fiches clôturées ; la première :", cloturees[0])

page 1/3 : 20 fiches
page 2/3 : 20 fiches
page 3/3 : 7 fiches
47 fiches clôturées ; la première : {'id': 1, 'visiteurId': 1, 'mois': '2026-08', 'etat': 'CL', 'montantValide': None}