Eine API für Öffnungszeiten.

Über 100 dokumentierte Endpunkte: Umkreissuche, Live-Status offen oder geschlossen und die Angaben jedes Standorts in 33 Sprachen. Die Widgets lesen dieselben Daten, deshalb stimmen App und Website immer überein.

dokumentierte Endpunkte
100+
durchsuchbare Abschnitte in der Dokumentation
680+
Sprachen, in denen die API antwortet
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" }    },    ...  ]}

Womit Sie arbeiten können

Standorte, Zeiten und Inhalte, hinter einer API.

Geschäfte

Standorte anlegen, lesen, ändern und löschen, durchsuchen, im Umkreis finden und ihren Änderungsverlauf abrufen.

GET /api/v2/shops

Die Suche funktioniert über alles hinweg: Autovervollständigung, Distanz und mehrere Filter gleichzeitig.

Angenehm zum Entwickeln

Vorhersehbar, dokumentiert und mehrsprachig.

  • Vorhersehbare REST-Konventionen und ein einheitliches Antwortformat
  • Klare Validierungsfehler, die sagen, was zu korrigieren ist
  • Seitenweise Ausgabe für lange Listen
  • Antworten in der Zeitzone des jeweiligen Standorts
  • Übersetzungen, mit Ersatzsprache, wenn eine fehlt
  • Rate Limiting und CORS für Browser-Apps
  • Interaktive Swagger-Dokumentation mit Codebeispielen, über 680 durchsuchbare Abschnitte

Interaktive API-Dokumentation

  • GET/api/v2/shopsGeschäfte suchen
  • POST/api/v2/shopsNeues Geschäft anlegen
  • GET/api/v2/shops/by-town/{townId}Geschäfte nach Ort auflisten
  • GET/api/v2/shops/sid/{sid}Geschäft nach SID abrufen
  • PUT/api/v2/shops/sid/{sid}Geschäft nach SID aktualisieren
  • GET/api/v2/search/townsOrte suchen
  • GET/api/v2/shops/pid/{pid}Geschäft nach PID abrufen
  • DELETE/api/v2/shops/sid/{sid}Geschäft nach SID löschen

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" }
        }
      }
    }
  ]
}

Was Sie damit bauen können

Bringen Sie die Öffnungszeiten in alles, was Sie bauen.

  • Mobile Apps

    Standortdaten, Fotos, Bewertungen und Live-Status für eine App, ohne eigene Datenbank.

  • Websites und Verzeichnisse

    Ihre eigenen Seiten und Einträge, gebaut auf denselben Daten wie die Widgets.

  • Filialfinder

    Umkreissuche und eine Antwort auf „jetzt offen“ für eine Karte in Ihrem eigenen Design.

  • Ihre anderen Systeme

    Halten Sie OpeningTimes mit Ihren anderen Werkzeugen synchron, indem Sie über dieselbe API lesen und schreiben.

Sie bauen etwas mit Öffnungszeiten?

Erzählen Sie uns, woran Sie arbeiten. Wir zeigen Ihnen die API und ihre Dokumentation und richten Ihr Konto ein.

Wir antworten innerhalb von 24 Stunden an Werktagen.