Dokumentation für Entwickler

Was es gibt

• Einbetten: Das Script widget.js macht aus einem div mit Token eine Karte. Beliebig viele Karten pro Seite, Einwilligungsmodus, Sprache, automatische Höhe und eine kleine JavaScript-Schnittstelle für Page-Builder und Single-Page-Apps.
• Verbinden: Ein Ablauf für Plugin-Entwickler. Ihr Plugin öffnet eine Adresse bei uns, die Person meldet sich an, wählt eine Karte, und Ihr Plugin bekommt den Karten-Token zurück. Kein Kopieren von Code, kein Geheimnis.
• REST-API: Standorte lesen, anlegen, ändern und archivieren, dazu Karten, Kategorien, Status und Anfragen lesen. Für Server-zu-Server-Anbindungen mit API-Key.
• Webhooks: Ihr System erfährt sofort von neuen Standorten, Änderungen, veröffentlichten Karten, Importen und Anfragen. Jede Zustellung ist mit HMAC-SHA256 signiert.

Was in welchem Tarif enthalten ist

Starter: 2 API-Keys und 10 Webhooks, Pro: 5 und 25, Business: unbegrenzt, siehe Preise. Den Verbinden-Ablauf und das Widget können Sie schon mit einem kostenlosen Konto testen.

Adressen

Alle Schnittstellen laufen über https://app.my-store-locator.com. Die Server stehen in Deutschland. Antworten sind JSON, Fehler kommen als { "error": "…", "message": "…" } mit passendem HTTP-Status. Die Meldung ist deutsch; mit dem Header X-MSL-Lang: en kommen die meisten Meldungen auf Englisch.

Die internen Endpunkte, die die Web-App selbst nutzt, sind keine öffentliche Schnittstelle und können sich ohne Ankündigung ändern. Verlassen Sie sich nur auf das, was auf diesen Seiten steht.

Neu

Webhooks lassen sich per API anlegen (z. B. für Zapier, Make und n8n), Standorte lassen sich nach Anlage- oder Änderungsdatum sortieren, und die OpenAPI-Datei ist öffentlich abrufbar. Alles steht auf den Seiten REST-API und Webhooks.

Hilfe ohne Programmierung

Wenn Sie nur Ihre Karte auf die Website bringen möchten, reicht die Hilfe zum Einbetten oder eine der Anleitungen für Ihr System. Fragen zur Anbindung beantworten wir über das Kontaktformular oder an info@my-store-locator.com.