Utiliser l'API REST

Principes de base

• URL de base : https://jenksguo.xyz/api/v1
• Aucune authentification pour les points de terminaison publics. Les réponses sont en JSON sauf mention contraire.
• Les points de terminaison GET autorisent les requêtes cross-origin. POST /api/v1/ask est limité par adresse IP.
• Listes complètes des paramètres : Référence de l'API REST.

Obtenir le brief

curl -s https://jenksguo.xyz/api/v1/brief

Le même brief est disponible en fichier à https://jenksguo.xyz/brief.md.

Lister les entrées, avec filtres

Tout le travail Web3 :

curl -s "https://jenksguo.xyz/api/v1/entries?tag=web3"

Uniquement les rôles de communauté et de gouvernance :

curl -s "https://jenksguo.xyz/api/v1/entries?kind=community"

Combiner des filtres : ?tag=consulting&lens=ai-transformation-consultant. Les tags sont it, engineering, ai, devrel, web3, business, marketing, consulting, hospitality, community et creative.

Obtenir une entrée, traduite

curl -s "https://jenksguo.xyz/api/v1/entries/xero-developer-evangelist?locale=zh"

Locales prises en charge : en (par défaut), zh, zh-hant, ja, fr, es, eo. Les intitulés de poste officiels et les noms d’organisation restent en anglais dans chaque locale.

Rechercher

curl -s "https://jenksguo.xyz/api/v1/search?q=hackathons"

Les résultats sont des passages avec le slug de l’entrée ou du document dont ils sont issus. Enchaînez avec /api/v1/entries/{slug}.

Lire un document

curl -s https://jenksguo.xyz/api/v1/documents/credentials

Documents : profile, credentials, capabilities, talks, thinking.

Interroger l’assistant

curl -s https://jenksguo.xyz/api/v1/ask \
  -H 'content-type: application/json' \
  -d '{"question": "What has Jenks built with AI agents?", "locale": "en"}'

Ajoutez des tours précédents avec "history": [{"role": "user", "content": "…"}, {"role": "assistant", "content": "…"}]. Si vous recevez 429, attendez une minute.

Exemple : créer une note de présélection avec jq

Les champs de réponse sont listés dans la Référence de l'API REST.

curl -s "https://jenksguo.xyz/api/v1/entries?lens=developer-advocate" \
  | jq -r '.entries[] | "- \(.title) — \(.org) (\(.period)): \(.summary)"'

Alternatives statiques

Si vous n’avez besoin que de fichiers, ceux-ci ne changent jamais de forme et se mettent bien en cache : /llms.txt, /llms-full.txt, /experience.json, /resume.json et /openapi.json.