Stadt Entenhausen

Eine Stadt. Viele Zugänge.

Website, Citychat und eigene Anwendungen sprechen dieselbe Sprache.

Mit einer Demo anfangen

Die Entenhausen-API stellt 16 Leistungen, deren Felder und feste Demofiguren bereit. Sie arbeitet mit echten, gespeicherten Demo-Vorgängen. Jeder Client kann einen Entwurf vorbereiten, eine Zusammenfassung anzeigen und nach ausdrücklicher Bestätigung einreichen. Ein wiederholter identischer Auftrag erzeugt keinen zweiten Vorgang.

OpenAPI herunterladen · Leistungskatalog · Hinweise für Agenten

Beispiel: nächster Vormittagstermin

1. POST /v1/sessions mit {} und Content-Type: application/json liefert eine zeitlich begrenzte Demo-Berechtigung.
2. GET /v1/slots/termin?period=vormittag mit Authorization: Bearer <token> liefert sortierte freie Termine.
3. POST /v1/drafts mit Leistung termin, Profil donald, Anliegen beratung, Zeitraum vormittag und einer angebotenen Slot-ID bereitet die Prüfung vor. Jeder Schreibaufruf braucht einen neuen Idempotency-Key aus 16 bis 100 Buchstaben, Ziffern, Unterstrichen oder Bindestrichen.
4. Zeigen Sie die vollständige Zusammenfassung. Erst nach einer ausdrücklichen Bestätigung folgt POST /v1/drafts/<id>/submit mit der gelieferten version und confirmed: true.
5. GET /v1/drafts/<id>/receipt liefert den PDF-Beleg. Lesen Sie Status und Ergebnis, bevor Sie Erfolg melden.

Für Sprachassistenten und Apps

„Den nächsten verfügbaren Termin an einem Vormittag“ lässt sich über genau diese Slots und denselben Prüfablauf abbilden. Ein Alexa-Skill oder eine Smarthome-Integration ist hier noch nicht installiert. Die API ist der nutzbare Anschluss dafür. Eine Sprachantwort allein darf keine Buchung behaupten.

Berechtigungen und Grenzen

Die zufällige Demo-Berechtigung gilt 24 Stunden und gehört nur zu einer Demowelt. Geben Sie sie nicht in URLs, Logs oder Modellprompts weiter. Es gibt keine echten Accounts oder Behördenzugriffe. Feste Auswahllisten verhindern die Erfassung persönlicher Daten. Browserzugriffe sind auf die veröffentlichten Website- und Citychat-Ursprünge begrenzt; Server-Clients können die öffentliche Demo-API direkt nutzen.

Entwürfe verfallen nach 15 Minuten. Änderungen an der Demo-Adresse erfordern eine neue Zusammenfassung. Veraltete Versionen, belegte Termine und widersprüchlich wiederverwendete Schlüssel liefern einen Konflikt. Anträge bleiben „Eingegangen“, solange kein abschließendes Ergebnis vorliegt.