API
Rechercher les objets ouverts
Rechercher les établissements ouverts sur une date, une période de 7 jours maximum et des tranches horaires.
GEThttps://api.millcheck.fr/public/opening-hours/search
Retourne, pour chaque objet disposant d’horaires Google, s’il est ouvert sur la période et les tranches horaires demandées. C’est l’endpoint idéal pour construire des filtres « ouvert maintenant », « ouvert ce midi » ou « ouvert cette semaine ».
Nécessite l’option Horaires sur votre organisation.
Paramètres
api_key
string required
Clé d’API de votre organisation.
date_start
string required
Date de début au format
YYYY-MM-DD, comprise entre aujourd’hui et J+7.date_end
string
Date de fin au format
YYYY-MM-DD, comprise entre date_start et J+7. Si absente, seule date_start est vérifiée.time_slot
string
Une ou plusieurs tranches horaires séparées par des virgules. Exemple :
noon,evening.details
integer
1 pour renvoyer les créneaux d’ouverture de date_start pour chaque objet. Par défaut : 0.Tranches horaires
| Valeur | Tranche | Plage |
|---|---|---|
now | Maintenant | Heure actuelle (fuseau Europe/Paris) |
morning | Matin | 07:00 – 12:00 |
noon | Midi | 12:00 – 14:00 |
afternoon | Après-midi | 14:00 – 19:00 |
evening | Soir | 19:00 – 00:00 |
Règles d’évaluation
- Les dates ne peuvent pas dépasser 7 jours glissants (limitation Google).
- Avec une
date_end, l’objet est considéré ouvert si au moins un jour de la période est valide. - Sans
time_slot, on vérifie simplement si l’objet est ouvert dans la journée. - Un objet est valide s’il est ouvert au moins 1 h dans la tranche horaire (sauf pour
now). - Avec plusieurs tranches, l’objet est valide dès qu’une tranche est satisfaite.
- Les objets sans données d’horaires sur les 7 prochains jours ne sont pas retournés.
Exemples
curl -G "https://api.millcheck.fr/public/opening-hours/search" \
--data-urlencode "api_key=VOTRE_CLE_API" \
--data-urlencode "date_start=2026-10-23" \
--data-urlencode "time_slot=now"
curl -G "https://api.millcheck.fr/public/opening-hours/search" \
--data-urlencode "api_key=VOTRE_CLE_API" \
--data-urlencode "date_start=2026-10-23" \
--data-urlencode "time_slot=evening" \
--data-urlencode "details=1"
curl -G "https://api.millcheck.fr/public/opening-hours/search" \
--data-urlencode "api_key=VOTRE_CLE_API" \
--data-urlencode "date_start=2026-10-23" \
--data-urlencode "date_end=2026-10-29"
Réponse
success
boolean
true si la requête a abouti.datas
object
Identifiant SIT → statut :
1 ouvert, 0 fermé.details
object
Uniquement si
details=1. Identifiant SIT → periods, la liste des créneaux d’ouverture de date_start (tous les créneaux du jour, indépendamment de time_slot).200 OK
{
"success": true,
"datas": {
"5978683": 1,
"5978990": 0,
"5979544": 1
},
"details": {
"5978683": { "periods": [{ "open": "09:00", "close": "12:00" }, { "open": "14:00", "close": "19:00" }] },
"5978990": { "periods": [] },
"5979544": { "periods": [{ "open": "00:00", "close": null }] }
}
}
Dans
details, un objet fermé ce jour-là renvoie periods: [] et un objet ouvert 24 h/24 renvoie { "open": "00:00", "close": null }.Erreurs
| Code | Message | Cause |
|---|---|---|
400 | api_key param is required | Paramètre api_key absent |
400 | date_start param is required | Paramètre date_start absent |
400 | date_start format is invalid | Date illisible |
400 | date_start must be between today and 7 days from now | Date hors de la fenêtre de 7 jours |
400 | date_end must be between date_start and 7 days from today | Date de fin incohérente |
400 | Invalid time_slot. Valid values: now, morning, noon, afternoon, evening | Tranche inconnue |
401 | api_key is not valid | Clé d’API inconnue |
403 | Cette organisation n'a pas accès aux horaires d'ouverture. | Option Horaires non souscrite |