Für Agents

Diese Website ist Patrick Iseneggers digitaler Notizgarten zu Medizin, Homelab, KI-Agenten und Aquarell. Beiträge und öffentliche Profildaten kannst du ohne Anmeldung lesen.

Inhalte finden und zitieren

Lies den vollständigen Beitrag und verlinke beim Zitieren seine Sprachversion. Verwende das angegebene Veröffentlichungs- oder Änderungsdatum; ein Abrufdatum sagt nichts darüber aus, wann der Inhalt zuletzt geprüft wurde.

Öffentliche JSON-APIs

Diese GET-Endpunkte benötigen keinen Token. Die Antworten enthalten ok, data und generatedAt. generatedAt ist der Erzeugungszeitpunkt der Antwort, kein Änderungsdatum der Daten. Die Antworten können fünf Minuten zwischengespeichert werden.

GET /api/v1/profile: Profil mit Name, Kurzbeschreibung, Ort, Website, Sprachen und Themen.
GET /api/v1/links: Kuratierte Werkzeuglinks mit id, name, category und url; count zählt die Treffer. Der optionale Filter category akzeptiert ai-agents, tooling, infrastructure oder automation. Unbekannte Kategorien liefern eine leere Liste.

Öffentliche Daten abrufen

curl --fail-with-body https://patrickisenegger.com/api/v1/profile
curl --fail-with-body 'https://patrickisenegger.com/api/v1/links?category=ai-agents'

Geschützter Status und Authentisierung

GET /api/v1/ai/status und POST /api/v1/agent/contact benötigen einen von Patrick bereitgestellten Bearer-Token oder ein gültiges OIDC-JWT, sofern OIDC eingerichtet ist. Zusätzliche Netzwerkbeschränkungen können gelten. Zugang kannst du über die Kontaktseite anfragen.

Authorization: Bearer YOUR_ACCESS_TOKEN

Der Status-Endpunkt liefert derzeit eine feste Service-Antwort mit healthy: true und mode: manual-updates. Sie enthält keine gemessenen Pipeline-Metriken und sagt nichts über Patricks Anwesenheit, Gesundheit oder Erreichbarkeit aus.

Fehlende oder ungültige Zugangsdaten ergeben 401; eine nicht zugelassene Herkunft ergibt 403. Fehlerantworten enthalten ok: false und message. Geschützte Antworten verwenden Cache-Control: no-store.

Als Agent Kontakt aufnehmen

POST /api/v1/agent/contact verschickt eine E-Mail an Patrick. Nutze diesen Endpunkt nur mit einem autorisierten Auftrag zum Senden und mit Zugangsdaten. Er ist kein öffentlicher Schreibzugang zur Website.

JSON-Felder

Content-Type: application/json

Pflichtfelder: agentName: 1–80 Zeichen; subject: 1–140 Zeichen; message: 20–4000 Zeichen.
Optionale Felder: replyTo: E-Mail-Adresse bis 200 Zeichen; contextUrl: bis 500 Zeichen. Zeichenketten werden vor der Validierung getrimmt.

200 mit ok: true und deliveredTo bedeutet, dass der Mail-Anbieter den Auftrag angenommen hat; es bestätigt weder das Lesen noch eine Antwort. Ungültiges JSON oder ungültige Felder ergeben 400, fehlende Mail-Konfiguration 500 und eine Ablehnung durch den Mail-Anbieter 502.

Kontakt und Zugang anfragen