Offre 20 % avec le code LANCEMENT20

API publique Perfecture

Construisez avec les données de disponibilités en préfecture

L’API Perfecture vous donne gratuitement accès à des données réelles de créneaux observés en préfecture. Aucune clé n’est nécessaire pour commencer.

Voir les endpointsExplorer les données

Référence

Endpoints disponibles

Toutes les réponses sont en JSON et les requêtes cross-origin sont autorisées.

GET/api/direct/departments

Catalogue des départements suivis, avec leurs démarches et organisations. Ajoutez catalog=1 pour recevoir le catalogue seul (sans les statistiques de créneaux, elles restent disponibles sur /api/direct/stats) : sa réponse est alors mise en cache une semaine.

Paramètres : basic=1, catalog=1 ou prefectures=1 (facultatifs)

GET/api/direct/slots

Créneaux actifs, volumes observés et créneaux récemment disparus.

Paramètres : department ou prefecture, demarche, puis month=YYYY-MM (facultatif)

GET/api/direct/stats

Volumes agrégés au niveau national ou pour un territoire.

Paramètres : department et prefecture (facultatifs)

GET/api/direct/map

Instantané géolocalisé des préfectures ayant des créneaux actifs.

Paramètres : Aucun paramètre

Démarrage rapide

Trois exemples prêts à copier

curl : créneaux disponibles

curl "https://perfecture.fr/api/direct/slots?department=gironde&demarche=titre-de-sejour"

Python : statistiques nationales

import requests

response = requests.get(
    "https://perfecture.fr/api/direct/stats",
    timeout=10,
)
response.raise_for_status()
stats = response.json()
print(stats)

JavaScript : carte des disponibilités

const response = await fetch("https://perfecture.fr/api/direct/map");

if (!response.ok) {
  throw new Error(`Erreur API : ${response.status}`);
}

const { points, generatedAt } = await response.json();
console.log({ points, generatedAt });
Validation : /api/direct/slots renvoie 400 si demarche ou le territoire manque. Un résultat sans disponibilité reste une réponse 200 avec des listes vides : ce n’est pas une erreur, seulement l’absence de créneau. Une vraie panne de lecture renvoie 500 avec un corps { "error": "read_failed" } : dans ce cas, réessayez plutôt que d’interpréter la réponse comme une absence de créneau.

Guide

Construire un outil avec l’API Perfecture

  1. 01

    Bot de suivi

    Interrogez régulièrement un département et une démarche, puis signalez les nouveaux créneaux dans Discord, Slack ou Telegram.

  2. 02

    Carte locale

    Affichez les points disponibles sur une carte et laissez vos utilisateurs explorer les préfectures proches de chez eux.

  3. 03

    Alerte personnalisée

    Déclenchez une notification lorsqu’un créneau correspond à un territoire, une démarche ou un mois choisi.

  4. 04

    Analyse de données

    Suivez les volumes de créneaux publiés et disparus pour étudier l’évolution de l’accès aux rendez-vous.

Limites et bonnes pratiques

  • Limite de 60 requêtes par minute et par adresse IP.
  • Au-delà, l’API répond avec le statut 429 et l’en-tête Retry-After: 60.
  • Respectez les en-têtes de cache et évitez de demander plusieurs fois une donnée inchangée.
  • Les données reflètent nos dernières observations et ne garantissent pas qu’un créneau restera réservable.

Créditez la source

Lorsque vous publiez ces données, nous vous recommandons d’afficher cette attribution dans l’interface de votre outil :

Source : Perfecture.fr