Adventskalender-Hotline

Gewinnabfrage-API für den KI-Telefonassistenten. Wird von ElevenLabs als Server-Tool aufgerufen.

Selbst ausprobieren

Endpunkte

Methode	Pfad	Zweck
GET	/api/pruefen?nummer=4711	Gewinnabfrage – das Server-Tool
GET	/api/status	Stichtag, Auflage, Anzahl Ziehungen
POST	/api/import	Gewinnliste ersetzen (CSV oder JSON)
GET	/healthz	Healthcheck

Testnummern

Nummer	Erwartetes Ergebnis
4711	Gewinn – Einkaufsgutschein, gezogen am 5. Dezember
1999	Gewinn – Weinpaket, am Stichtag gezogen
1234	Gewinn – Wellness-Wochenende
2000	kein Gewinn – gewinnt erst am 24. Dezember
1777	kein Gewinn, Ziehungen noch offen
9999	unbekannt – außerhalb der Auflage

Kernregel. Die API gibt ausschließlich Ziehungen bis einschließlich zum Stichtag zurück. Ein zukünftiger Gewinn wird als „bisher nicht gezogen“ beantwortet – sonst wäre die komplette Gewinnliste über die Telefonhotline abrufbar. Diese Prüfung sitzt serverseitig und nicht im Prompt des Sprachassistenten: Ein Prompt ist keine Zugriffskontrolle.

Gewinnliste aktualisieren

CSV mit Semikolon, wie Excel es im deutschen Gebietsschema exportiert:

nummer;datum;preis;sponsor
4711;2026-12-05;ein Einkaufsgutschein ueber 100 Euro;Modehaus Berger
1999;2026-12-10;ein Weinpaket mit sechs Flaschen;Weingut Sommer

curl -X POST https://adventskalender-hotline.ai-base.cloud/api/import \
  -H "x-api-key: $API_TOKEN" \
  -H "Content-Type: text/csv" \
  --data-binary @gewinne.csv