Version bêta : des champs peuvent être ajoutés sans préavis. Aucun champ n'est renommé ni retiré dans /api/v1. Statut et versions

Départements

Sur cette page

GET /departements

Départements et nombre d'avis ouverts

Identifiant d'opération : listDepartements

Tous les départements (métropole, Corse et outre-mer) avec le nombre d'avis ouverts des sources servies, sans doublons : le compteur d'un département égale meta.total de GET /avis?departement=<code>. Un département sans avis vaut 0. La liste compte 107 départements, triés par code : 01 à 95 (sans 20), 2A, 2B, 971 à 978 et 986 à 988. Les codes 975, 977, 978, 986, 987 et 988 sont les collectivités d'outre-mer (Saint-Pierre-et-Miquelon, Saint-Barthélemy, Saint-Martin, Wallis-et-Futuna, Polynésie française, Nouvelle-Calédonie). Un avis dont le code de département est vide ou 00 n'est compté dans aucun département. Aucun périmètre requis : toute clé valide.

Clé requise, toute clé valide.

Réponses

CodeDescription
200Succès.
401unauthorized : Clé d'API manquante ou invalide.
403forbidden : Accès refusé : compte non Pro ou périmètre de la clé insuffisant.
429rate_limited : Trop de requêtes. Réessayez plus tard.
503unavailable : Service momentanément indisponible.

Exemple

bash
curl -H "X-API-Key: pk_live_VOTRE_CLE" "https://publikconnect.fr/api/v1/departements"

Demander une clé

  1. Avoir un compte Pro

    La clé est réservée aux comptes au plan Pro.

    Créer un compteVoir les offres

  2. Écrire au support

    support@publikconnect.fr

    Nous vérifions votre compte Pro puis vous répondons par e-mail avec votre clé.