Une API pour les horaires.
Plus de 100 points d'accès documentés : recherche par distance, statut ouvert ou fermé en direct, et le détail de chaque point de vente en 33 langues. Les widgets lisent les mêmes données : votre application et votre site sont toujours d'accord.
- points d'accès documentés
- 100+
- sections de documentation consultables
- 680+
- langues dans lesquelles l'API répond
- 33
$GET /api/v2/shops?search=bakery&latitude=46.52&longitude=6.63&radius_km=5
200application/json
{ "status": "success", "data": [ { "id": 123, "sid": "shop_xyz789", "name": "Boulangerie Petit Cadran", "town": { "name": "Lausanne", "postcode": "1003" } }, ... ]}
Ce que vous pouvez utiliser
Points de vente, horaires et contenus, derrière une seule API.
Magasins
Créer, lire, modifier et supprimer des points de vente, les rechercher, les trouver par distance et consulter l'historique de leurs modifications.
GET /api/v2/shops
La recherche porte sur l'ensemble : saisie semi-automatique, distance et plusieurs filtres à la fois.
Agréable à intégrer
Prévisible, documentée et multilingue.
- Des conventions REST prévisibles et un seul format de réponse
- Des erreurs de validation claires qui disent quoi corriger
- Pagination pour les longues listes
- Des réponses dans le fuseau horaire de chaque point de vente
- Des traductions, avec une langue de repli quand l'une manque
- Limitation du débit, et CORS pour les applications web
- Documentation Swagger interactive avec exemples de code, plus de 680 sections consultables
Documentation interactive de l'API
- GET/api/v2/shopsRechercher des magasins
- POST/api/v2/shopsCréer un magasin
- GET/api/v2/shops/by-town/{townId}Lister les magasins par localité
- GET/api/v2/shops/sid/{sid}Obtenir un magasin par SID
- PUT/api/v2/shops/sid/{sid}Modifier un magasin par SID
- GET/api/v2/search/townsRechercher des localités
- GET/api/v2/shops/pid/{pid}Obtenir un magasin par PID
- DELETE/api/v2/shops/sid/{sid}Supprimer un magasin par SID
200application/json
{
"status": "success",
"data": [
{
"id": 123,
"sid": "shop_xyz789",
"version": 4,
"locale": "fr",
"name": "Boulangerie Petit Cadran",
"description": "Pain au levain",
"url": "https://example.com",
"town": {
"name": "Lausanne",
"postcode": "1003",
"translations": {
"de": { "name": "Lausanne" },
"it": { "name": "Losanna" }
}
}
}
]
}Ce que vous pouvez construire avec
Intégrez les horaires à tout ce que vous construisez.
Applications mobiles
Données des points de vente, photos, avis et statut en direct pour une application, sans gérer votre propre base de données.
Sites web et annuaires
Vos propres pages et fiches, construites sur les mêmes données que les widgets.
Localisateurs de magasins
Recherche par distance et réponse « ouvert maintenant » pour une carte à votre image.
Vos autres systèmes
Synchronisez OpeningTimes avec vos autres outils en lisant et en écrivant par la même API.
Vous construisez quelque chose avec des horaires ?
Dites-nous ce que vous construisez. Nous vous présentons l'API et sa documentation, et créons votre compte.
Nous répondons dans les 24 heures les jours ouvrables.