{"openapi":"3.0.0","info":{"title":"Poligraph API","version":"1.1.0","description":"API publique pour accéder aux données des représentants politiques français.\n\n## Endpoints disponibles\n\n| Endpoint | Description |\n|----------|-------------|\n| `/api/politiques` | Liste des représentants politiques |\n| `/api/politiques/{slug}` | Détails d'un représentant |\n| `/api/politiques/{slug}/affaires` | Affaires judiciaires d'un représentant |\n| `/api/politiques/{slug}/votes` | Votes parlementaires d'un représentant |\n| `/api/politiques/{slug}/relations` | Relations d'un représentant |\n| `/api/affaires` | Toutes les affaires judiciaires documentées |\n| `/api/votes` | Liste des scrutins parlementaires |\n| `/api/partis` | Liste des partis politiques |\n| `/api/partis/{slug}` | Détails d'un parti politique |\n| `/api/mandats` | Liste des mandats politiques |\n| `/api/elections` | Liste des élections |\n| `/api/elections/{slug}` | Détails d'une élection |\n\n## Pagination\n\nLes endpoints de liste supportent la pagination :\n- `page` : Numéro de page (défaut: 1)\n- `limit` : Éléments par page (défaut: 20, max: 100)\n\n## Utilisation responsable\n\nMerci de faire un usage raisonnable de l'API.\n\nLes exports CSV (`/api/export/affaires`, `/api/export/politiques`, `/api/export/factchecks`, `/api/export/votes`) acceptent 5 requêtes par minute et par adresse IP, sur une fenêtre glissante. Au-delà, l'API répond `429` et indique dans l'en-tête `Retry-After` le nombre de secondes à attendre. Chaque réponse porte aussi `X-RateLimit-Limit`, `X-RateLimit-Remaining` et `X-RateLimit-Reset` (horodatage Unix en millisecondes).\n\nLe paramètre `limit` plafonne chaque export à 50 000 enregistrements par requête, et un export peut rester en cache jusqu'à 24 heures. Un téléchargement par jour suffit pour suivre les mises à jour. Un client qui continue d'envoyer des requêtes malgré les réponses `429` est refusé en amont de l'API, sans ces en-têtes.","contact":{"name":"Poligraph","url":"https://poligraph.fr"},"license":{"name":"AGPL-3.0","url":"https://www.gnu.org/licenses/agpl-3.0.html"}},"tags":[{"name":"Politiques","description":"Représentants politiques français"},{"name":"Partis","description":"Partis politiques français"},{"name":"Mandats","description":"Mandats politiques (députés, sénateurs, ministres, etc.)"},{"name":"Élections","description":"Élections et candidatures"},{"name":"Élus locaux","description":"Élus locaux (maires, conseillers municipaux, etc.)"},{"name":"Territoires","description":"Communes, départements et régions : élus, parlementaires, résultats, sources"},{"name":"Affaires","description":"Affaires judiciaires documentées avec sources"},{"name":"Fact-checks","description":"Fact-checks des déclarations publiques"},{"name":"Votes","description":"Votes parlementaires (scrutins publics)"},{"name":"Relations","description":"Relations entre représentants politiques"},{"name":"Exports","description":"Exports CSV en masse pour l'analyse statistique"}],"paths":{},"components":{}}