Un'API per gli orari.
Oltre 100 endpoint documentati: ricerca per distanza, stato aperto o chiuso in tempo reale e i dettagli di ogni sede in 33 lingue. I widget leggono gli stessi dati, così la tua app e il tuo sito sono sempre d'accordo.
- endpoint documentati
- 100+
- sezioni di documentazione consultabili
- 680+
- lingue in cui risponde l'API
- 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" } }, ... ]}
Con cosa puoi lavorare
Sedi, orari e contenuti, dietro un'unica API.
Negozi
Crea, leggi, aggiorna ed elimina sedi, cercale, trovale per distanza e consulta la cronologia delle modifiche.
GET /api/v2/shops
La ricerca funziona su tutto: completamento automatico, distanza e più filtri insieme.
Piacevole da usare per sviluppare
Prevedibile, documentata e multilingue.
- Convenzioni REST prevedibili e un unico formato di risposta
- Errori di validazione chiari che dicono cosa correggere
- Paginazione per gli elenchi lunghi
- Risposte nel fuso orario di ogni sede
- Traduzioni, con una lingua di riserva quando ne manca una
- Limiti di frequenza, e CORS per le app nel browser
- Documentazione Swagger interattiva con esempi di codice, oltre 680 sezioni ricercabili
Documentazione interattiva dell'API
- GET/api/v2/shopsCerca negozi
- POST/api/v2/shopsCrea un nuovo negozio
- GET/api/v2/shops/by-town/{townId}Elenca i negozi per località
- GET/api/v2/shops/sid/{sid}Ottieni un negozio per SID
- PUT/api/v2/shops/sid/{sid}Aggiorna un negozio per SID
- GET/api/v2/search/townsCerca località
- GET/api/v2/shops/pid/{pid}Ottieni un negozio per PID
- DELETE/api/v2/shops/sid/{sid}Elimina un negozio per 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" }
}
}
}
]
}Cosa puoi costruirci
Porta gli orari in tutto ciò che costruisci.
App mobili
Dati delle sedi, foto, recensioni e stato in tempo reale per un'app, senza gestire un tuo database.
Siti web e directory
Le tue pagine e le tue schede, costruite sugli stessi dati che mostrano i widget.
Trova negozi
Ricerca per distanza e una risposta «aperto ora» per una mappa disegnata da te.
Gli altri tuoi sistemi
Tieni OpeningTimes allineato con gli altri tuoi strumenti, leggendo e scrivendo tramite la stessa API.
Stai costruendo qualcosa con gli orari?
Raccontaci cosa stai costruendo. Ti mostriamo l'API e la sua documentazione e configuriamo il tuo account.
Rispondiamo entro 24 ore nei giorni lavorativi.