Una API para horarios.
Más de 100 endpoints documentados: búsqueda por distancia, el estado abierto o cerrado en directo y los datos de cada ubicación en 33 idiomas. Los widgets leen los mismos datos, así su app y su sitio web siempre coinciden.
- endpoints documentados
- 100+
- secciones de documentación con búsqueda
- 680+
- idiomas en los que responde la 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 qué puede trabajar
Ubicaciones, horarios y contenidos, detrás de una sola API.
Tiendas
Cree, consulte, actualice y elimine ubicaciones, búsquelas, encuéntrelas por distancia y consulte su historial de cambios.
GET /api/v2/shops
La búsqueda abarca todo: autocompletado, distancia y varios filtros a la vez.
Agradable para desarrollar
Predecible, documentada y multilingüe.
- Convenciones REST previsibles y un único formato de respuesta
- Errores de validación claros que indican qué corregir
- Paginación para listas largas
- Respuestas en la zona horaria de cada ubicación
- Traducciones, con un idioma de respaldo cuando falta alguna
- Limitación de peticiones y CORS para apps de navegador
- Documentación interactiva en Swagger con ejemplos de código y más de 680 secciones con búsqueda
Documentación interactiva de la API
- GET/api/v2/shopsBuscar tiendas
- POST/api/v2/shopsCrear una tienda
- GET/api/v2/shops/by-town/{townId}Listar tiendas por localidad
- GET/api/v2/shops/sid/{sid}Obtener una tienda por SID
- PUT/api/v2/shops/sid/{sid}Actualizar una tienda por SID
- GET/api/v2/search/townsBuscar localidades
- GET/api/v2/shops/pid/{pid}Obtener una tienda por PID
- DELETE/api/v2/shops/sid/{sid}Eliminar una tienda por 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" }
}
}
}
]
}Qué puede construir con ella
Lleve los horarios a todo lo que construya.
Apps móviles
Datos de ubicaciones, fotos, opiniones y estado en directo para una app, sin mantener su propia base de datos.
Sitios web y directorios
Sus propias páginas y fichas, construidas con los mismos datos que muestran los widgets.
Buscadores de tiendas
Búsqueda por distancia y una respuesta «abierto ahora» para un mapa con su propio diseño.
Sus otros sistemas
Mantenga OpeningTimes sincronizado con sus otras herramientas leyendo y escribiendo a través de la misma API.
¿Está creando algo con horarios?
Cuéntenos qué está creando. Le mostraremos la API y su documentación, y configuraremos su cuenta.
Respondemos en 24 horas los días laborables.