LegifranceClient

LegifranceClient est le point d’entrée unique pour tous les appels à l’API Legifrance. Il encapsule :

• la configuration (ApiConfig) ;
• l’authentification OAuth PISTE (voir concepts/piste-oauth) ;
• une requests.Session avec gestion des timeouts ;
• les méthodes call_api, get, ping.

Construire un client

Deux façons :

from pylegifrance import LegifranceClient

# 1. Depuis l'environnement (LEGIFRANCE_CLIENT_ID / _SECRET dans .env)
client = LegifranceClient()

# 2. Manuellement, avec un ApiConfig explicite
from pylegifrance.config import ApiConfig

client = LegifranceClient(
    ApiConfig(client_id="...", client_secret="...")
)

Les identifiants sont obligatoires ; sinon une erreur est levée à l’instanciation.

Cycle de vie

with client.session_context():
    ...  # appels API

Le contexte ferme proprement la session à la sortie.

Méthodes

Méthode	Rôle
call_api(route, data)	POST JSON vers route
get(route)	GET vers route
ping(route="consult/ping")	Vérifie l’accès à l’API
update_api_keys(...)	Change les identifiants à chaud

Pour la signature complète, voir /references/client.

Voir aussi

• ApiConfig — forme de la config passée au client.
• Authentication — ce qui se passe avant chaque appel.
• Fond Code, Fond Juri, Fond LODA — façades qui consomment le client.