API REST

Base URL: https://jenksguo.pages.dev. JSON sauf indication contraire; GET /api/v1/brief renvoie du Markdown (envoyez Accept: application/json pour { markdown }). Lisible par machine : OpenAPI.

Points de terminaison

Méthode	Chemin	Outil	Ce qu'il fait
GET	/api/v1/brief	get_brief	Une page de synthèse en Markdown sur Jenks Guo : positionnement, poste actuel, trajectoire de carrière, points forts, langues, contact et comment aller plus loin.
GET	/api/v1/entries	list_experience	Liste les expériences, projets, rôles communautaires et formations de Jenks (du plus récent au plus ancien), avec possibilité de filtrer par étiquette d'industrie, prisme de rôle ou type.
GET	/api/v1/entries/{slug}	get_entry	Rédaction longue et complète d'une expérience, d'un projet, d'un rôle communautaire ou d'une formation par slug : aperçu, ce que Jenks a fait, réalisations, pourquoi cela compte pour les employeurs, résultats clés, compétences, liens de preuve.
GET	/api/v1/lenses	list_lenses	Les prismes de rôle sous lesquels les employeurs peuvent voir Jenks (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) avec un pitch, des lacunes honnêtes et des décomptes de preuves.
GET	/api/v1/search	search_jenks	Recherche par mots-clés dans chaque entrée et document.
GET	/api/v1/documents/{name}	get_document	L’un des documents de référence de Jenks : profile (profil central), credentials (éducation, certifications), capabilities (carte capacité → preuves), talks (conférences, podcasts, écrits), thinking (point de vue : sept vues, chacune expliquée en termes simples avec des exemples, plus d’autres convictions).
GET	/api/v1/cv	list_cvs	Le CV téléchargeable de Jenks (PDF) — le AI Lead CV — avec version, date, une URL PDF stable, une URL de téléchargement, une image d’aperçu et des versions antérieures.
GET	/api/v1/cv/{slug}	get_cv	Un CV par slug : titre, résumé, version, l’URL PDF stable (toujours la version actuelle, p. ex.
GET	/api/v1/arguments	list_arguments	Les arguments en faveur de Jenks par capacité — AI transformation, agentic systems, leadership, enterprise integration, DevRel, Web3 partnerships et cross-project technical program leadership — chacun avec son affirmation, son qualificateur et sa force.
GET	/api/v1/arguments/{slug}	get_argument	Un argument par slug : l’argument formel (prémisses → conclusion), preuves chiffrées (slugs d’entrées), statistiques de marché avec sources, limites honnêtes, objections équitables avec réponses, attaques fallacieuses (formelles et informelles) avec répliques, et quand l’argument ne s’applique pas.
POST	/api/v1/ask	ask_jenks	Poser une question en langage naturel à l’assistant Ask Jenks (adéquation au rôle, cadrage de conseil, conseils en transformation IA, histoires STAR, gouvernance…).
POST	/api/chat	—	Chat en streaming utilisé par le widget du site (flux texte brut ; events: true entrelace des lignes d’état \u001e ; voice: true demande une courte réponse parlée).
POST	/api/transcribe	—	Repli vocal : transcrire de l’audio base64.
POST	/api/speak	—	Lire du texte à voix haute pour le mode vocal du widget : { text, locale } → audio (Anglais : Deepgram Aura-2 'theia', une voix féminine australienne ; autres langues : un modèle audio OpenRouter).
GET	/api/health	—	Vivacité et configuration.
GET	/cv/{slug}.pdf	—	La version actuelle d’un CV en PDF (lien stable ; ?download=1 force le téléchargement). /cv/{slug}/{version}.pdf sert une version spécifique.
GET	/media/{key}	—	Images, vidéos et PDF téléversés (R2). URLs immuables ; prend en charge Range et If-None-Match.
GET	POST	/mcp	—

Erreurs et limites

• 400 bad_request, 404 not_found, 429 rate_limited (ask : 20/min/IP), 503 quand une clé de modèle n’est pas configurée.
• Les points de terminaison GET envoient Access-Control-Allow-Origin: * ; les points de terminaison POST sont destinés aux agents côté serveur.

get_brief — Obtenir le brief de Jenks

Une page de synthèse en Markdown sur Jenks Guo : positionnement, poste actuel, trajectoire de carrière, points forts, langues, contact et comment aller plus loin. Commencez ici.

• MCP: get_brief on https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/brief
• CLI: jenks brief

Aucun argument.

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

list_experience — Lister l’expérience

Liste les expériences, projets, rôles communautaires et formations de Jenks (du plus récent au plus ancien), avec possibilité de filtrer par étiquette d’industrie, prisme de rôle ou type. Renvoie des formes courtes : titre, organisation, période, résumé, résultat clé, URL de page.

• MCP: list_experience on https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/entries?tag=&lens=&kind=&locale=
• CLI: jenks list [--tag it] [--lens solution-architect] [--kind project]

Argument	Type	Obligatoire	Notes
tag	it · engineering · ai · devrel · web3 · business · marketing · consulting · hospitality · community · creative	non
lens	head-of-ai · ai-transformation-consultant · engineering-manager · solution-architect · system-integrator · support-engineer · ict-specialist · developer-advocate · developer-evangelist · digital-marketer · hospitality	non
kind	experience · education · community · project	non
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

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

get_entry — Obtenir une entrée

Rédaction longue et complète d’une expérience, d’un projet, d’un rôle communautaire ou d’une formation par slug : aperçu, ce que Jenks a fait, réalisations, pourquoi cela compte pour les employeurs, résultats clés, compétences, liens de preuve.

• MCP: get_entry on https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/entries/{slug}?locale=
• CLI: jenks get <slug>

Argument	Type	Obligatoire	Notes
slug	string	oui	Slug de l’entrée, p. ex. xero-developer-evangelist
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

curl -s "https://jenksguo.pages.dev/api/v1/entries/xero-developer-evangelist"

list_lenses — Lister les prismes de rôle

Les prismes de rôle sous lesquels les employeurs peuvent voir Jenks (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) avec un pitch, des lacunes honnêtes et des décomptes de preuves.

• MCP: list_lenses on https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/lenses?locale=
• CLI: jenks lenses

Argument	Type	Obligatoire	Notes
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

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

search_jenks — Rechercher dans le corpus

Recherche par mots-clés dans chaque entrée et document. Renvoie les passages les plus pertinents avec leurs slugs.

• MCP: search_jenks on https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/search?q=
• CLI: jenks search "<query>"

Argument	Type	Obligatoire	Notes
query	string	oui

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

get_document — Obtenir un document

L’un des documents de référence de Jenks : profile (profil central), credentials (éducation, certifications), capabilities (carte capacité → preuves), talks (conférences, podcasts, écrits), thinking (point de vue : sept vues, chacune expliquée en termes simples avec des exemples, plus d’autres convictions).

• MCP: get_document on https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/documents/{name}?locale=
• CLI: jenks doc <name>

Argument	Type	Obligatoire	Notes
name	profile · credentials · capabilities · talks · thinking	oui
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

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

list_cvs — Lister les CV de Jenks

Le CV téléchargeable de Jenks (PDF) — le AI Lead CV — avec version, date, une URL PDF stable, une URL de téléchargement, une image d’aperçu et des versions antérieures. Pour les questions sur son expérience Web3, get_cv avec le slug web3 renvoie le AI and Web3 CV (non listé ici).

• MCP: list_cvs on https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/cv?locale=
• CLI: jenks cv

Argument	Type	Obligatoire	Notes
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

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

get_cv — Obtenir un CV

Un CV par slug : titre, résumé, version, l’URL PDF stable (toujours la version actuelle, p. ex. https://jenksguo.pages.dev/cv/ai.pdf), l’URL de téléchargement et toutes les versions. Utilisez ai pour le AI Lead CV ; utilisez web3 pour le AI and Web3 CV lorsqu’on pose des questions sur son expérience Web3.

• MCP: get_cv on https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/cv/{slug}?locale=
• CLI: jenks cv <slug> [--download] [-o file.pdf]

Argument	Type	Obligatoire	Notes
slug	string	oui	ai (le AI Lead CV) ou web3 (le AI and Web3 CV, pour les questions Web3)
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

curl -s "https://jenksguo.pages.dev/api/v1/cv/xero-developer-evangelist"

list_arguments — Lister le dossier pour Jenks

Les arguments en faveur de Jenks par capacité — AI transformation, agentic systems, leadership, enterprise integration, DevRel, Web3 partnerships et cross-project technical program leadership — chacun avec son affirmation, son qualificateur et sa force.

• MCP: list_arguments on https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/arguments?locale=
• CLI: jenks argue

Argument	Type	Obligatoire	Notes
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

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

get_argument — Obtenir un argument, avec objections

Un argument par slug : l’argument formel (prémisses → conclusion), preuves chiffrées (slugs d’entrées), statistiques de marché avec sources, limites honnêtes, objections équitables avec réponses, attaques fallacieuses (formelles et informelles) avec répliques, et quand l’argument ne s’applique pas. Utilisez-le pour tester l’adéquation de Jenks, pas seulement pour la promouvoir.

• MCP: get_argument on https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/arguments/{slug}?locale=
• CLI: jenks argue <slug>

Argument	Type	Obligatoire	Notes
slug	string	oui	ai-transformation, agentic-systems, leadership, enterprise-integration, devrel, web3-partnerships ou technical-program-leadership
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

curl -s "https://jenksguo.pages.dev/api/v1/arguments/xero-developer-evangelist"

ask_jenks — Poser une question à l’assistant de Jenks

Posez une question en langage naturel à l’assistant Ask Jenks (adéquation au rôle, cadrage du conseil, conseils de transformation IA, histoires STAR, gouvernance…). Il exécute ses propres outils sur le corpus et répond dans la langue demandée. Limité en débit.

• MCP: ask_jenks on https://jenksguo.pages.dev/mcp
• REST: POST /api/v1/ask
• CLI: jenks ask "<question>"

Argument	Type	Obligatoire	Notes
question	string	oui
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).
history	array	non	Tours précédents optionnels.

curl -s -X POST https://jenksguo.pages.dev/api/v1/ask \
  -H 'content-type: application/json' \
  -d '{"question":"Is Jenks a fit for a Head of AI role?"}'