Einstieg

Für KI-Assistenten

Die Doku als reiner Text, damit dein Coding-Assistent die Anbindung für dich schreibt.

Die gesamte Dokumentation gibt es als reinen Text. So kann ein Coding-Assistent wie Claude Code oder Cursor sie lesen und die Anbindung für dich schreiben.

Adressen für die KI

Adresse	Inhalt
/llms-full.txt	Die komplette Dokumentation in einer Datei. Im Zweifel diese.
/llms.txt	Kurzes Inhaltsverzeichnis mit Links auf alle Seiten als Markdown.
`/docs/<seite>.md`	Jede einzelne Seite als Markdown, zum Beispiel /docs/senden.md.

Prompt zum Kopieren

Gib deinem Assistenten diesen Auftrag und ersetze den Teil in eckigen Klammern:

Text

Lies zuerst die Samy-Dokumentation unter https://samy.sinio.io/llms-full.txt.

Baue dann in dieses Projekt eine Anbindung an Samy ein:
- Eine Funktion, die eine Push-Nachricht über POST https://api-production-e537a.up.railway.app/v1/push schickt.
- Der Schlüssel kommt aus der Umgebungsvariable SAMY_KEY und steht nie im Code.
- Fehler (400, 401, 429) werden sichtbar gemeldet und nicht verschluckt.
- [Beschreibe hier, wann eine Nachricht kommen soll und welche Knöpfe sie hat.]

Wenn Knöpfe ohne url vorkommen: Baue zusätzlich einen Webhook-Endpunkt, der die
Signatur im Header X-Samy-Signature prüft und auf button_id reagiert.

Das Wichtigste in Kürze

Für Assistenten, die nur diese Seite lesen:

Senden: POST https://api-production-e537a.up.railway.app/v1/push, Header Authorization: Bearer <SAMY_KEY> und Content-Type: application/json.
Body: text ist Pflicht (bis 10.000 Zeichen). Optional: title (bis 80), url, image, priority (normal, high, silent), buttons (bis 3).
Knopf: {"id": "…", "label": "…"} meldet den Tipp per Webhook. Mit zusätzlichem "url" öffnet er einen Link.
Erfolg: Status 200 mit {"message_id": "…"}.
Fehler: 400 invalid_body, 401 missing_key oder invalid_key, 429 rate_limited (60 Aufrufe pro Minute und Schlüssel).
Webhook: POST an die Webhook-URL des Packlets mit message_id, packlet_id, button_id, pressed_at. Signatur: X-Samy-Signature: sha256=<HMAC-SHA256(Body, sha256_hex(SAMY_KEY))>.

Die Einzelheiten stehen auf Nachricht senden, Knöpfe und Webhook.