# Perfecture.fr

> Service français de suivi des disponibilités de rendez-vous en préfecture.

## Pages de référence

- [Accueil](https://perfecture-saas-buf36qgeb-willlls-projects-de26b596.vercel.app/)
- [Préfectures](https://perfecture-saas-buf36qgeb-willlls-projects-de26b596.vercel.app/prefectures): Fiches par préfecture (adresse, contact, démarches disponibles).
- [Créneaux en direct](https://perfecture-saas-buf36qgeb-willlls-projects-de26b596.vercel.app/direct): Vue interactive département par département, avec sélection de la démarche.
- [Catégories de démarches](https://perfecture-saas-buf36qgeb-willlls-projects-de26b596.vercel.app/categories)
- [Sitemap](https://perfecture-saas-buf36qgeb-willlls-projects-de26b596.vercel.app/sitemap.xml)

## Données publiques en temps réel (JSON)

- [Créneaux disponibles](https://perfecture-saas-buf36qgeb-willlls-projects-de26b596.vercel.app/api/direct/slots?department={department_slug}&prefecture={prefecture_code}&demarche={demarche_code}): État actuel des créneaux d'une démarche dans une préfecture, créneaux actifs, créneaux disparus récemment, horodatage du dernier scan (`lastChecked`, par palier : moins de 1 h, 6 h, 12 h, 24 h, ou plus de 24 h). Paramètre optionnel `month=YYYY-MM` pour cibler un mois précis.
- [Statistiques agrégées](https://perfecture-saas-buf36qgeb-willlls-projects-de26b596.vercel.app/api/direct/stats?department={department_slug}&prefecture={prefecture_code}): Volume de créneaux actifs/disparus, au niveau national ou filtré par département/préfecture.
- [Catalogue des départements et démarches](https://perfecture-saas-buf36qgeb-willlls-projects-de26b596.vercel.app/api/direct/departments): Liste des départements suivis, avec compteurs de démarches et organisations par département.
- [Carte nationale des créneaux actifs](https://perfecture-saas-buf36qgeb-willlls-projects-de26b596.vercel.app/api/direct/map): Snapshot géolocalisé des préfectures ayant des créneaux disponibles.

## Notes

- Toutes les réponses ci-dessus sont en JSON public, sans authentification, mises en cache de 15 secondes à 5 minutes selon l'endpoint.
- `department` accepte un slug (ex: `paris`, `guyane`) ; `prefecture` et `demarche` acceptent soit leur code interne soit le slug utilisé dans l'URL de la page `/direct` correspondante.
- Les disponibilités sont indicatives et peuvent changer. Perfecture.fr n'est pas un service de l'État.