API
Démarrer avec l’API
URL de base, authentification par clé d’API, format des réponses et liste des endpoints publics de Millcheck.
L’API Millcheck est réservée aux clients ayant souscrit au service auprès de l’Agence Mill. Elle permet de récupérer la liste des objets ayant des données valides et de rechercher les objets disponibles ou ouverts pour une date ou une période donnée.
URL de base
https://api.millcheck.fr/public
Tous les endpoints sont en GET et retournent du JSON.
Authentification
Chaque requête doit contenir votre clé d’API dans le paramètre api_key :
curl "https://api.millcheck.fr/public/objects?api_key=VOTRE_CLE_API"
La clé est rattachée à votre organisation : elle détermine les objets auxquels vous avez accès et les options (disponibilités, horaires) dont vous bénéficiez. Elle vous est communiquée par l’Agence Mill.
La clé d’API transite dans l’URL : appelez l’API depuis votre serveur (back-office, CMS, tâche planifiée) plutôt que depuis le navigateur de vos visiteurs, pour ne pas l’exposer publiquement.
Format des réponses
Toutes les réponses contiennent un booléen success.
{
"success": true,
"datas": [5978683, 5978990, 5979544]
}
{
"success": false,
"message": "api_key is not valid"
}
Les dates sont toujours au format YYYY-MM-DD. Les objets sont identifiés par leur identifiant SIT.
Avant tout développement, prévoyez la récupération quotidienne de la liste des objets actifs : c’est elle qui détermine quels objets afficher sur votre site.