Integrationen

Partner-API

Lies regionale Flohmarkttermine direkt als JSON und gestalte deine eigene Anwendung. Die Partner-API braucht eine freigegebene Partner-ID vom Typ API. Widget und MCP sind getrennte Zugänge.

Termine suchen

Gib deine ausgegebene, aktive Partner-ID vom Typ API bei jedem Aufruf als partnerId an. Eine Widget-ID wird an diesem Endpunkt abgelehnt. Grenze die Region mit einer PLZ-Liste oder einer PLZ mit Umkreis ein. Suchtext und Datumsbereich kannst du ergänzen.

HTTP

GET https://api.my-flohmarkt.de/integrations/v1/events?partnerId=DEINE-PARTNER-ID&postcodes=92637,92648&limit=20&offset=0
Origin: https://deine-website.example

Ist für deine Partner-ID eine Website hinterlegt, muss der Origin-Header genau zu dieser Freigabe passen: Protokoll, Hostname und Port zählen. Der Browser setzt ihn automatisch. Bei einem direkten Serveraufruf sende ihn wie im Beispiel mit. Andere oder fehlende Origins erhalten 403; www und andere Subdomains sind eigenständige Origins. Ohne hinterlegte Website gibt es keine Herkunftsbindung.

Die Website-Freigabe begrenzt fremde Browser-Einbindungen. Ein Serverprogramm kann den Origin-Header jedoch selbst setzen. Weder die sichtbare Partner-ID noch CORS beweisen die Herkunft eines solchen Aufrufs; das ist keine starke API-Authentisierung.

Deine Partner-ID bekommst du von uns

Schick uns deine Website, die gewünschte Region und die Zugangsart: Widget oder direkte API. Wir prüfen die Anfrage und geben die Partner-ID für diesen Typ frei. Für beide Zugänge brauchst du getrennte IDs. Bei hinterlegter Website erlauben wir Datenaufrufe nur mit deren Origin. Die ID ist eine öffentliche Kennung, kein geheimer Zugangsschlüssel.

Öffnet dein E-Mail-Programm mit einem vorbereiteten Text. Die Anfrage wird erst versendet, wenn du sie dort abschickst.

Suchparameter der Partner-API

partnerId: Pflicht: ausgegebene, aktive Partner-ID vom Typ API. Keine Widget-ID und keine Anmeldung per Cookie.
postcodes: Bis zu 500 genaue fünfstellige PLZ, mit Komma getrennt. Alternative zur Umkreissuche.
postcode + radiusKm: Fünfstellige Mittelpunkt-PLZ und positiver Radius bis 200 km. Beide gemeinsam angeben; nicht mit postcodes kombinieren.
q: Optionaler Suchtext, höchstens 120 Zeichen
dateFrom / dateTo: Optionaler Zeitraum als YYYY-MM-DD; das Ende darf nicht vor dem Anfang liegen.
limit: 1–50 Ergebnisse pro Antwort; Standard: 20
offset: 0–1.000; Standard: 0. Für die nächste Seite um limit erhöhen.

Antworten richtig verwenden

Die Antwort enthält items, total, limit, offset und hasMore. Jeder Eintrag hat id, title, date, timeFrom, timeTo, city, plz und url. Verlinke den Markt über url. Wenn hasMore wahr ist, kannst du die nächste Seite innerhalb des Offset-Limits abrufen.

Höchstens 50 Ergebnisse pro Antwort, Offset höchstens 1.000. Ergebnisdaten können 30 Minuten im HTTP-Cache liegen. Beachte HTTP 429 und Retry-After. Ein Fehler ist keine leere Suche. Die Schnittstelle liest Termine; sie schreibt keine Märkte, bucht keine Stände und verwaltet keine Konten.

OpenAPI-Vertrag öffnen Datenstand & Methodik

Getrennte Zugänge für API und Widget

Die direkte Partner-API verwendet /integrations/v1/events mit einer API-ID. Unser Widget lädt über /integrations/v1/widget/events mit einer Widget-ID. Suchparameter und Antwortformat sind gleich; die Freigaben und Nutzungswerte sind getrennt. Im Widget übernimmt unser JavaScript die Aufrufe und die Darstellung.

HTTP · Widget

GET https://api.my-flohmarkt.de/integrations/v1/widget/events?partnerId=DEINE-WIDGET-PARTNER-ID&postcodes=92637,92648&limit=20&offset=0
Origin: https://deine-website.example

400: fehlende/ungültige ID oder Parameter. 403: unbekannte/deaktivierte ID, falscher Zugangstyp oder nicht freigegebene Herkunft. 503: Dienst vorübergehend nicht verfügbar. Beide Endpunkte liefern items, total, limit, offset und hasMore. offset ist auf 1.000 begrenzt.

Alle Widget-Parameter