Utiliser l'API REST

Principes de base

• Base URL: https://jenksguo.pages.dev/api/v1
• Aucune authentification pour les endpoints publics. Les réponses sont en JSON sauf indication contraire.
• Les endpoints GET autorisent les requêtes cross-origin. POST /api/v1/ask est soumis à une limitation de débit par IP.
• Listes complètes des paramètres : REST API reference.

Récupérer le brief

curl -s https://jenksguo.pages.dev/api/v1/brief

Le même brief est disponible en tant que fichier à https://jenksguo.pages.dev/brief.md.

Lister les entrées, filtrées

Tout le travail Web3 :

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

Uniquement les rôles communautaires et de gouvernance :

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

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

Récupérer une entrée, traduite

curl -s "https://jenksguo.pages.dev/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’organisations restent en anglais dans toutes les locales.

Recherche

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

Les résultats sont des passages accompagnés du slug de l’entrée ou du document d’origine. Enchaînez avec /api/v1/entries/{slug}.

Lire un document

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

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

Interroger l’assistant

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

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

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

Les champs de réponse sont répertoriés dans la REST API reference.

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

Alternatives statiques

Si vous avez seulement besoin 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.