Cinq points d’entrée
GET /api/dataset.json- Le jeu complet, paginé (limit, offset). Champs imbriqués : horaires par saison, tarifs par catégorie.
GET /api/dataset.csv- Une ligne par château, colonnes à plat. Encodé UTF-8 avec BOM pour s’ouvrir correctement dans Excel.
GET /api/chateau/{slug}.json- Une fiche. Chaque champ pratique porte sa source et sa date de vérification.
GET /fr/chateau/{slug}.md- La même fiche en Markdown, sans navigation ni script. Suffixez .md à n’importe quelle URL de fiche, dans les trois langues. Sans clé.
GET /llms.txt- Description du corpus, licence, manière de nous citer et points d’entrée. Sans clé.
Authentification
La clé passe dans l’en-tête Authorization. Un paramètre ?key= est accepté pour les outils qui ne savent pas envoyer d’en-tête, mais il finit dans les logs des proxys : préférez l’en-tête.
curl -H "Authorization: Bearer ck_live_…" \
https://chateaupedia.com/api/dataset.json?limit=100Limites
- 5 000 appels par jour et par clé. Écrivez-nous si vous avez besoin de plus, c’est en général accordé.
- Seules les fiches publiées sont exposées. Une fiche en cours de vérification n’apparaît pas.
- Un champ dont la vérification a expiré n’est pas renvoyé, plutôt que renvoyé périmé.
Licence
ODbL 1.0. Vous pouvez réutiliser, modifier et redistribuer, y compris commercialement, à condition de citer Chateaupedia et de partager les mêmes libertés sur les données dérivées.
Demander une clé
L’attribution est manuelle pour l’instant : nous lisons chaque demande. Comptez 48 heures ouvrées.
