REST API

Base URL: https://jenksguo.xyz. JSON krom se notite; GET /api/v1/brief redonas Markdown (sendu Accept: application/json por { markdown }). Maŝinlegebla: OpenAPI.

Finpunktoj

Metodo	Vojo	Ilo	Kion ĝi faras
GET	/api/v1/brief	get_brief	Unu-paĝa Markdown-resumo pri Jenks Guo: poziciigado, nuna rolo, kariera kurbo, fortoj, lingvoj, kontakto, kaj kiel plu esplori.
GET	/api/v1/entries	list_experience	Listigas la spertojn, projektojn, komunumarolojn kaj edukon de Jenks (plej novaj unue), laŭvole filtrite per industria etikedo, rola lenso aŭ speco.
GET	/api/v1/entries/{slug}	get_entry	Plenlonga priskribo de unu sperto, projekto, komunumarolo aŭ eduk-ero laŭ slug: superrigardo, kion Jenks faris, atingoj, kial tio gravas por dungantoj, ĉefaj rezultoj, kapabloj, pruvoligiloj..
GET	/api/v1/lenses	list_lenses	La rolo-lensoj tra kiuj dungantoj povas rigardi Jenks (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) kun prezento, honestaj mankoj kaj kvantoj de evidentoj..
GET	/api/v1/search	search_jenks	Ŝlosilvorta serĉo tra ĉiu ero kaj dokumento.
GET	/api/v1/documents/{name}	get_document	Unu el la referencaj dokumentoj de Jenks: profile (kerna profilo), credentials (eduko, atestiloj), capabilities (kapablo → evidentmapo), talks (prelegoj, podkastoj, skribaĵoj), thinking (mondrigardo)..
POST	/api/v1/ask	ask_jenks	Faru al la asistanto Ask Jenks natur-lingvan demandon (rolo-taŭgeco, konsilada amplekso, konsiloj pri AI-transformo, STAR-rakontoj, regado…).
POST	/api/chat	—	Fluiga babilado uzata de la retpaĝa fenestraĵo (plenteksta fluo; events: true enmiksas \u001e status-liniojn).
POST	/api/transcribe	—	Voĉa rezervo: transskribu base64-aŭdon.
GET	/api/health	—	Viveco kaj agordo.
GET	POST	/mcp	—

Eraroj kaj limoj

• 400 bad_request, 404 not_found, 429 rate_limited (ask: 20/min/IP), 503 kiam model-ŝlosilo ne estas agordita.
• GET-finpunktoj sendas Access-Control-Allow-Origin: *; POST-finpunktoj estas por servilflankaj agentoj.

get_brief — Ricevu la resumon de Jenks

Unu-paĝa Markdown-resumo pri Jenks Guo: poziciigado, nuna rolo, kariera kurbo, fortoj, lingvoj, kontakto, kaj kiel plu esplori. Komencu ĉi tie.

• MCP: get_brief ĉe https://jenksguo.xyz/mcp
• REST: GET /api/v1/brief
• CLI: jenks brief

Neniuj argumentoj.

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

list_experience — Listigu sperton

Listigas la spertojn, projektojn, komunumarolojn kaj edukon de Jenks (plej novaj unue), laŭvole filtrite per industria etikedo, rola lenso aŭ speco. Redonas mallongajn formojn: titolo, organizo, periodo, resumo, ĉefa rezulto, paĝa URL.

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

Argumento	Tipo	Deviga	Notoj
tag	it · engineering · ai · devrel · web3 · business · marketing · consulting · hospitality · community · creative	ne
lens	head-of-ai · ai-transformation-consultant · engineering-manager · solution-architect · system-integrator · support-engineer · ict-specialist · developer-advocate · developer-evangelist · digital-marketer · hospitality	ne
kind	experience · education · community · project	ne
locale	en · zh · zh-hant · ja · fr · es · eo	ne	Lingvo por tradukitaj kampoj (defaŭlte en).

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

get_entry — Akiru unu eron

Plenlonga priskribo de unu sperto, projekto, komunumarolo aŭ eduk-ero laŭ slug: superrigardo, kion Jenks faris, atingoj, kial tio gravas por dungantoj, ĉefaj rezultoj, kapabloj, pruvoligiloj.

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

Argumento	Tipo	Deviga	Notoj
slug	string	jes	Enira slug, ekz. xero-developer-evangelist
locale	en · zh · zh-hant · ja · fr · es · eo	ne	Lingvo por tradukitaj kampoj (defaŭlte en).

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

list_lenses — Listigu rolo-lensojn

La rolo-lensoj tra kiuj dungantoj povas rigardi Jenks (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) kun prezento, honestaj mankoj kaj kvantoj de evidentoj.

• MCP: list_lenses ĉe https://jenksguo.xyz/mcp
• REST: GET /api/v1/lenses?locale=
• CLI: jenks lenses

Argumento	Tipo	Deviga	Notoj
locale	en · zh · zh-hant · ja · fr · es · eo	ne	Lingvo por tradukitaj kampoj (defaŭlte en).

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

search_jenks — Serĉu la korpuson

Ŝlosilvorta serĉo tra ĉiu ero kaj dokumento. Redonas la plej kongruajn pasaĵojn kun iliaj slug-oj.

• MCP: search_jenks ĉe https://jenksguo.xyz/mcp
• REST: GET /api/v1/search?q=
• CLI: jenks search "<query>"

Argumento	Tipo	Deviga	Notoj
query	string	jes

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

get_document — Akiru dokumenton

Unu el la referencaj dokumentoj de Jenks: profile (kerna profilo), credentials (eduko, atestiloj), capabilities (kapablo → evidenta mapo), talks (prelegoj, podkastoj, verkado), thinking (mondrigardo).

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

Argumento	Tipo	Deviga	Notoj
name	profile · credentials · capabilities · talks · thinking	jes
locale	en · zh · zh-hant · ja · fr · es · eo	ne	Lingvo por tradukitaj kampoj (defaŭlte en).

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

ask_jenks — Demandu la asistanton de Jenks

Faru al la asistanto Ask Jenks natur-lingvan demandon (rolo-taŭgeco, konsilada difinado, konsiloj pri AI-transformo, STAR-rakontoj, regado…). Ĝi funkciigas siajn proprajn ilojn super la korpuso kaj respondas en la petita lingvo. Kun indico-limigo.

• MCP: ask_jenks ĉe https://jenksguo.xyz/mcp
• REST: POST /api/v1/ask
• CLI: jenks ask "<question>"

Argumento	Tipo	Deviga	Notoj
question	string	jes
locale	en · zh · zh-hant · ja · fr · es · eo	ne	Lingvo por tradukitaj kampoj (defaŭlte en).
history	array	ne	Nedevigaj pli fruaj turnoj.

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