API- und MCP-Dokumentation
Die öffentliche API des Kreisverbands Die PARTEI Reutlingen liefert Nachrichten, Informationsseiten und lokale Veranstaltungen. Die Schnittstellen sind lesend und ohne Konto, API-Schlüssel oder OAuth zugänglich. Alle Datumsangaben sollten zusammen mit dem Quellenlink ausgewertet werden.
API-Schnellstart
- Nächster lokaler Termin:
GET /api/v1/termine. Das Feldnext_evententhält Datum und Quelle. Bei einem leeren Ergebnis erläutertnext_event_messageden Stand. - Aktuelle Ansprechpartner:
GET /api/v1/inhalte/kontakt. - Quellen zu einem Thema:
GET /api/v1/suche?q=Gemeinderat. Prüfepublished_atundinformation_status, bevor du eine Aussage als aktuell zitierst.
Listen liefern zehn Ergebnisse pro Seite. Folge links.next bis zum Ende. Bei HTTP 429 gibt Retry-After die Wartezeit in Sekunden an. Der OpenAPI-Vertrag dokumentiert Parameter und Antwortfelder.
MCP für Agenten
Verbinde einen MCP-Client über Streamable HTTP mit https://www.die-partei-reutlingen.de/mcp. Starte über tools/list. Rufe für den nächsten Termin termine_suchen mit {} auf. Für die Kontaktseite nutze inhalt_lesen mit {"slug":"kontakt"}. Die Server Card beschreibt den Endpunkt. Der Agenten-Leitfaden enthält weitere Einstiege.
Versionierung und Deprecation
Die Versionsnummer der HTTP-API steht im Pfad. Neue Felder können in /api/v1 hinzukommen. Inkompatible Änderungen erhalten einen neuen Versionspfad. Wenn das Ende einer Version feststeht, wird es hier mit Datum und einem Link zur Nachfolge veröffentlicht.
