Pour les agents

Ce site est le jardin numérique de Patrick Isenegger : médecine, homelab, agents IA et aquarelle. Les articles et les données publiques du profil sont accessibles sans connexion.

Trouver et citer les contenus

Lis l’article complet et cite l’URL de la version linguistique consultée. Utilise sa date de publication ou de mise à jour ; la date de consultation ne dit pas quand le contenu a été vérifié.

API JSON publiques

Ces endpoints GET ne nécessitent aucun token. Les réponses contiennent ok, data et generatedAt. generatedAt indique la génération de la réponse, pas la dernière modification des données. Les réponses peuvent être mises en cache pendant cinq minutes.

GET /api/v1/profile
Profil avec nom, présentation, lieu, site, langues et centres d’intérêt.
GET /api/v1/links
Liens vers des outils avec id, name, category et url ; count indique le nombre de résultats. Le filtre facultatif category accepte ai-agents, tooling, infrastructure ou automation. Une catégorie inconnue renvoie une liste vide.

Consulter les données publiques

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

Statut protégé et authentification

GET /api/v1/ai/status et POST /api/v1/agent/contact nécessitent un token Bearer fourni par Patrick ou un JWT OIDC valide si OIDC est configuré. Des restrictions réseau supplémentaires peuvent s’appliquer. Demande un accès via la page de contact.

Authorization: Bearer YOUR_ACCESS_TOKEN

L’endpoint de statut renvoie actuellement une réponse fixe du service avec healthy: true et mode: manual-updates. Elle ne contient aucune mesure de pipeline et ne renseigne pas sur la présence, la santé ou la disponibilité de Patrick.

Des identifiants absents ou invalides donnent 401 ; une origine non autorisée donne 403. Les erreurs contiennent ok: false et message. Les réponses protégées utilisent Cache-Control: no-store.

Contacter Patrick comme agent

POST /api/v1/agent/contact envoie un e-mail à Patrick. Utilise cet endpoint uniquement avec une demande d’envoi autorisée et des identifiants valides. Il ne permet pas de modifier publiquement le site.

Champs JSON

Content-Type: application/json

Champs obligatoires
agentName : 1–80 caractères ; subject : 1–140 caractères ; message : 20–4000 caractères.
Champs facultatifs
replyTo : adresse e-mail de 200 caractères au maximum ; contextUrl : 500 caractères au maximum. Les espaces en début et fin de chaîne sont supprimés avant validation.

200 avec ok: true et deliveredTo signifie que le fournisseur de messagerie a accepté la demande ; cela ne confirme ni la lecture ni une réponse. Un JSON ou des champs invalides donnent 400, une configuration e-mail manquante donne 500 et un refus du fournisseur donne 502.

Contact et demande d’accès