Exposez des données événementielles propres, sécurisées et prêtes à consommer
L’API EventsDatas permet de consulter des événements normalisés, lancer des exports, récupérer des flux cartographiques et intégrer des traitements sécurisés dans vos applications, portails, sites médias ou systèmes tiers.
🔐 Authentification
Utilisez votre clé API pour accéder aux endpoints selon vos droits, quotas et périmètres autorisés.
📅 Événements
Interrogez les événements, les flux live, les recherches géographiques et les données cartographiques.
📤 Exports
Déclenchez un export direct ou asynchrone selon le volume et le format attendu.
Premiers pas
1. Récupérer une clé API
Votre organisation reçoit une clé API associée à des droits d’accès, des quotas et éventuellement à des filtres métiers spécifiques.
2. Appeler l’API
Passez votre clé dans les en-têtes HTTP puis interrogez les endpoints disponibles.
curl -X GET "https://api.eventsdatas.cloud/api/v1/events" \
-H "Accept: application/json" \
-H "X-API-Key: votre_cle_api"3. Lire la réponse JSON
Les réponses renvoient des structures cohérentes, paginées lorsque nécessaire, avec métadonnées utiles à l’intégration.
{
"data": [
{
"id": "evt_12345",
"title": "Festival de printemps",
"status": "published",
"starts_at": "2026-04-12T14:00:00+00:00",
"ends_at": "2026-04-12T22:00:00+00:00",
"city": "Beauvais"
}
],
"meta": {
"current_page": 1,
"per_page": 25,
"total": 1
}
}Fonctionnalités couvertes
- consultation des événements normalisés ;
- recherche d’événements en direct ;
- recherche géolocalisée ;
- flux cartographiques et clusters ;
- exports CSV directs ou asynchrones ;
- journalisation et sécurité des usages.
Convention générale
| Élément | Valeur |
|---|---|
| Base URL | https://api.eventsdatas.cloud/api/v1 |
| Format | JSON |
| Authentification | Header X-API-Key |
| Encodage | UTF-8 |
| Fuseau recommandé | ISO 8601 |