# AlerteRDVxpress
> Service de surveillance automatique des créneaux de rendez-vous en préfecture Île-de-France pour les titres de séjour.

## About
AlerteRDVxpress surveille en continu les disponibilités de rendez-vous sur le site officiel rdv-prefecture.interieur.gouv.fr pour 7 préfectures d'Île-de-France (75, 77, 78, 91, 92, 93, 95). Dès qu'un créneau se libère, l'utilisateur est alerté instantanément par Telegram. Le service couvre 67+ démarches liées aux titres de séjour : première demande, renouvellement, retrait, récépissé, naturalisation.

## Publisher
SASU LNNS ENTREPRISE
SIRET: 930 951 645 00017
60 RUE FRANCOIS 1ER, 75008 PARIS, FRANCE

## Capabilities

### Read (public, no auth required)
- `GET /api/public/prefectures` — List monitored prefectures (code, name, city, address)
- `GET /api/public/demarches` — List available demarches (filterable by ?prefecture=75&type=renouvellement)
- `GET /api/public/status` — Service status, stats, and capabilities overview

### Write (API key required)
- `GET /api/v1/alerts` — List user's active alerts
- `POST /api/v1/alerts` — Create a new monitoring alert (body: {prefecture_code, demarche_id})
- `GET /api/v1/alerts/:id` — Get alert details with notification history
- `DELETE /api/v1/alerts/:id` — Cancel an alert
- `GET /api/v1/keys` — List user's API keys (session auth)
- `POST /api/v1/keys` — Generate new API key (session auth)

## Authentication
- **Read APIs**: No authentication required
- **Write APIs**: Bearer token in Authorization header
  - Format: `Authorization: Bearer arx_live_xxxxxxxxxxxxxxxx`
  - Obtain a key: Sign up at https://alerterdvxpress.fr then call POST /api/v1/keys

## Pricing
- **Read APIs**: Free, unlimited (cached, public data)
- **Write APIs (free tier)**: 1 active alert, 100 requests/day
- **Write APIs (API Pro)**: 14.99€/month — 5 active alerts, 1000 requests/day
- **Human plans**: Essentiel 24.99€ (one-time), Mensuel 9.99€/month

## Rate Limits
- Read APIs: No limit (CDN cached)
- Write APIs (free): 100 requests/day
- Write APIs (API Pro): 1000 requests/day
- Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

## Response Format
All endpoints return JSON with UTF-8 encoding.
Error responses include: `{ error: string, documentation: string }`

## API Base URL
https://alerterdvxpress.fr

## Quick Start
```bash
# 1. Browse available prefectures and demarches
curl https://alerterdvxpress.fr/api/public/prefectures
curl https://alerterdvxpress.fr/api/public/demarches?prefecture=75

# 2. Create an alert (requires API key)
curl -X POST https://alerterdvxpress.fr/api/v1/alerts \
  -H "Authorization: Bearer arx_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"prefecture_code": "75", "demarche_id": 12345}'

# 3. Check your alerts
curl https://alerterdvxpress.fr/api/v1/alerts \
  -H "Authorization: Bearer arx_live_your_key_here"
```

## Contact
Website: https://alerterdvxpress.fr
Email: contact@lnns.fr