API DÉVELOPPEURS

Intégrez AlerteRDVxpress dans vos outils

Accédez aux données préfectures IDF, démarches et disponibilités en temps réel. Read APIs publiques et gratuites. Write APIs disponibles sur abonnement.

📖 Read APIs — Accès public gratuit

GET
/api/public/prefectures

Liste des 8 préfectures IDF avec leur statut de support.

curl https://alerterdvxpress.fr/api/public/prefectures

// Réponse exemple

[
  {
    "code": "75",
    "nom": "Préfecture de Paris",
    "ville": "Paris",
    "is_supported": true
  },
  ...
]
GET
/api/public/demarches

Toutes les démarches disponibles. Filtrage par département avec ?dept=75

curl https://alerterdvxpress.fr/api/public/demarches?dept=93

// Réponse exemple

[
  {
    "id": 12,
    "label": "Titre de séjour — 1ère demande",
    "prefecture": "Seine-Saint-Denis",
    "dept": "93",
    "rdv_id": 4206
  },
  ...
]
GET
/api/public/status

Statut de l'API et métriques publiques (uptime, alertes actives).

curl https://alerterdvxpress.fr/api/public/status

// Réponse exemple

{
  "status": "operational",
  "uptime": "99.9%",
  "active_alerts": 42,
  "last_check": "2026-03-07T14:30:00Z"
}

✏️ Write APIs — Plan API Pro

Créez et gérez des alertes programmatiquement. Nécessite une clé API (abonnement API Pro).

GET
/api/v1/alertsAPI Key requise

Liste vos alertes actives.

curl -H "X-API-Key: votre_cle" \
  https://alerterdvxpress.fr/api/v1/alerts
POST
/api/v1/alertsAPI Key requise

Crée une nouvelle alerte pour une démarche donnée.

curl -X POST \
  -H "X-API-Key: votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"demarche_id": 12, "telegram_id": "123456789"}' \
  https://alerterdvxpress.fr/api/v1/alerts
GET
/api/v1/keysAPI Key requise

Informations sur votre clé API (quota, usage).

curl -H "X-API-Key: votre_cle" \
  https://alerterdvxpress.fr/api/v1/keys

Plan API Pro

  • ✅ Accès complet aux Write APIs
  • ✅ 5 alertes simultanées
  • ✅ 1 000 requêtes / jour
  • ✅ Compatible agents IA (x402 protocol)
  • ✅ Support prioritaire

14,99€

par mois

Obtenir une clé API

⚡ Limites & Authentification

Authentification : Header X-API-Key: votre_cle

Rate limit : 100 req/jour (gratuit) · 1 000 req/jour (API Pro)

x402 Protocol : Les endpoints Write retournent HTTP 402 sans abonnement — compatible agents IA autonomes.

Format : JSON · UTF-8 · HTTPS uniquement

🤖 Intégration Agents IA

AlerteRDVxpress est agent-ready. Notre fichier AGENTS.md décrit les capacités de l'API pour les agents autonomes (LLM, AutoGPT, n8n, Make...).

📄 Lire AGENTS.md →

Une question ? Un cas d'usage spécifique ?

contact@alerterdvxpress.fr