Dokumentaro / reference
REST API
Publikaj legeblaj finpunktoj sub /api/v1 kaj la aliaj HTTP-finpunktoj, generitaj el la sama specifo kiel la MCP-iloj.
Base URL: https://jenksguo.pages.dev. JSON krom se notite; GET /api/v1/brief liveras Markdown (sendu Accept: application/json por { markdown }). Maŝinlegebla: OpenAPI.
Endpoints
| Metodo | Vojo | Ilo | Kion ĝi faras |
|---|---|---|---|
| GET | /api/v1/brief |
get_brief |
Unupaĝa Markdown-resumo pri Jenks Guo: poziciigo, nuna rolo, kariera arko, fortoj, lingvoj, kontakto, kaj kiel esplori plu. |
| GET | /api/v1/entries |
list_experience |
Listigas la spertojn, projektojn, komunumarolojn kaj edukadon de Jenks (la plej novaj unue), laŭvole filtritaj 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ŭ slugo: superrigardo, kion Jenks faris, atingoj, kial tio gravas por dungantoj, kernaj rezultoj, kapabloj, pruvoligoj. |
| GET | /api/v1/lenses |
list_lenses |
La rolo-lensoj tra kiuj dungantoj povas rigardi Jenks-on (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) kun prezento, honestaj mankoj kaj kvantoj de pruvoj. |
| 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 (kora profilo), credentials (edukado, atestiloj), capabilities (kapablo → pruvo-mapo), talks (paroladoj, podkastoj, verkoj), thinking (vidpunkto: sep vidpunktoj, ĉiu klarigita en simplaj vortoj kun ekzemploj, plus pliaj kredoj). |
| GET | /api/v1/cv |
list_cvs |
Elŝutebla VIVO (PDF) de Jenks — la AI Lead CV — kun versio, dato, stabila PDF-URL, elŝuta URL, antaŭrigarda bildo kaj pli fruaj versioj. |
| GET | /api/v1/cv/{slug} |
get_cv |
Unu VIVO laŭ slugo: titolo, resumo, versio, la stabila PDF-URL (ĉiam la nuna versio, ekzemple |
| GET | /api/v1/arguments |
list_arguments |
La argumentoj por Jenks laŭ kapablo — AI transformation, agentic systems, leadership, enterprise integration, DevRel, Web3 partnerships kaj interprojekta teknika programa gvidado — ĉiu kun sia aserto, kvalifilo kaj forto. |
| GET | /api/v1/arguments/{slug} |
get_argument |
Unu argumento laŭ slugo: la formala argumento (premisoj → konkludo), pruvoj kun nombroj (ero-slugoj), merkataj statistikoj kun fontoj, honestaj limoj, justaj obĵetoj kun respondoj, falsaĵaj atakoj (formala kaj neformala) kun respondoj, kaj kiam la argumento ne aplikiĝas. |
| POST | /api/v1/ask |
ask_jenks |
Faru al la Ask Jenks asistanto demandojn en natura lingvo (rola taŭgeco, konsilada amplekso, AI-transforma konsilo, STAR-rakontoj, mastrumado…). |
| POST | /api/chat |
— | Fluanta babilado uzata de la reteja fenestraĵo (plenteksta fluo; events: true interplektas \u001e statusliniojn; voice: true petas mallongan parolitan respondon). |
| POST | /api/transcribe |
— | Voĉa rezervo: transkribas base64-aŭdion. |
| POST | /api/speak |
— | Laŭtlegas tekston por la voĉreĝimo de la fenestraĵo: { text, locale } → audio (English: Deepgram Aura-2 'theia', aŭstralia ina voĉo; other languages: an OpenRouter audio model). |
| GET | /api/health |
— | Viveco kaj agordo. |
| GET | /cv/{slug}.pdf |
— | La nuna versio de VIVO kiel PDF (stabila ligilo; ?download=1 ĝin elŝutas). /cv/{slug}/{version}.pdf liveras specifan version. |
| GET | /media/{key} |
— | Alŝutitaj bildoj, videoj kaj PDF-oj (R2). Neŝanĝeblaj URL-oj; subtenas Range kaj If-None-Match. |
| GET | POST | /mcp |
— |
Eraroj kaj limoj
400 bad_request,404 not_found,429 rate_limited(ask: 20/min/IP),503kiam modela ŝlosilo ne estas agordita.- GET-finpunktoj sendas
Access-Control-Allow-Origin: *; POST-finpunktoj estas por servilaj agentoj.
get_brief — Preni la resumon de Jenks
Unupaĝa Markdown-resumo pri Jenks Guo: poziciigo, nuna rolo, kariera arko, fortoj, lingvoj, kontakto, kaj kiel esplori plu. Komencu ĉi tie.
- MCP:
get_briefĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/brief - CLI:
jenks brief
Neniuj argumentoj.
curl -s "https://jenksguo.pages.dev/api/v1/brief"
list_experience — Listigi spertojn
Listigas la spertojn, projektojn, komunumarolojn kaj edukadon de Jenks (la plej novaj unue), laŭvole filtritaj per industria etikedo, rola lenso aŭ speco. Redonas mallongajn formojn: titolo, organizo, periodo, resumo, ŝlosila rezulto, paĝa URL.
- MCP:
list_experienceĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/entries?tag=&lens=&kind=&locale= - CLI:
jenks list [--tag it] [--lens solution-architect] [--kind project]
| Argumento | Tipo | Bezonata | 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.pages.dev/api/v1/entries"
get_entry — Preni unu eron
Plenlonga priskribo de unu sperto, projekto, komunumarolo aŭ eduk-ero laŭ slugo: superrigardo, kion Jenks faris, atingoj, kial tio gravas por dungantoj, kernaj rezultoj, kapabloj, pruvoligoj.
- MCP:
get_entryĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/entries/{slug}?locale= - CLI:
jenks get <slug>
| Argumento | Tipo | Bezonata | Notoj |
|---|---|---|---|
slug |
string | jes | Ero-slugo, ekzemple xero-developer-evangelist |
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/entries/xero-developer-evangelist"
list_lenses — Listigi rolo-lensojn
La rolo-lensoj tra kiuj dungantoj povas rigardi Jenks-on (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) kun prezento, honestaj mankoj kaj kvantoj de pruvoj.
- MCP:
list_lensesĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/lenses?locale= - CLI:
jenks lenses
| Argumento | Tipo | Bezonata | Notoj |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/lenses"
search_jenks — Serĉi la korpuson
Ŝlosilvorta serĉo tra ĉiu ero kaj dokumento. Redonas la plej kongruajn pasaĝojn kun iliaj slugoj.
- MCP:
search_jenksĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/search?q= - CLI:
jenks search "<query>"
| Argumento | Tipo | Bezonata | Notoj |
|---|---|---|---|
query |
string | jes |
curl -s "https://jenksguo.pages.dev/api/v1/search"
get_document — Preni dokumenton
Unu el la referencaj dokumentoj de Jenks: profile (kora profilo), credentials (edukado, atestiloj), capabilities (kapablo → pruvo-mapo), talks (paroladoj, podkastoj, verkoj), thinking (vidpunkto: sep vidpunktoj, ĉiu klarigita en simplaj vortoj kun ekzemploj, plus pliaj kredoj).
- MCP:
get_documentĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/documents/{name}?locale= - CLI:
jenks doc <name>
| Argumento | Tipo | Bezonata | 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.pages.dev/api/v1/documents/credentials"
list_cvs — Listigi la VIVOjn de Jenks
Elŝutebla VIVO (PDF) de Jenks — la AI Lead CV — kun versio, dato, stabila PDF-URL, elŝuta URL, antaŭrigarda bildo kaj pli fruaj versioj. Por demandoj pri lia Web3-sperto, get_cv kun slugo web3 liveras la AI and Web3 CV (ne listigita ĉi tie).
- MCP:
list_cvsĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/cv?locale= - CLI:
jenks cv
| Argumento | Tipo | Bezonata | Notoj |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/cv"
get_cv — Preni unu VIVOn
Unu VIVO laŭ slugo: titolo, resumo, versio, la stabila PDF-URL (ĉiam la nuna versio, ekzemple https://jenksguo.pages.dev/cv/ai.pdf), la elŝuta URL kaj ĉiuj versioj. Uzu ai por la AI Lead CV; uzu web3 por la AI and Web3 CV kiam iu demandas pri lia Web3-sperto.
- MCP:
get_cvĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/cv/{slug}?locale= - CLI:
jenks cv <slug> [--download] [-o file.pdf]
| Argumento | Tipo | Bezonata | Notoj |
|---|---|---|---|
slug |
string | jes | ai (la AI Lead CV) aŭ web3 (la AI and Web3 CV, por Web3-demandoj) |
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/cv/xero-developer-evangelist"
list_arguments — Listigi la kazon por Jenks
La argumentoj por Jenks laŭ kapablo — AI transformation, agentic systems, leadership, enterprise integration, DevRel, Web3 partnerships kaj interprojekta teknika programa gvidado — ĉiu kun sia aserto, kvalifilo kaj forto.
- MCP:
list_argumentsĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/arguments?locale= - CLI:
jenks argue
| Argumento | Tipo | Bezonata | Notoj |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/arguments"
get_argument — Preni unu argumenton, kun obĵetoj
Unu argumento laŭ slugo: la formala argumento (premisoj → konkludo), pruvoj kun nombroj (ero-slugoj), merkataj statistikoj kun fontoj, honestaj limoj, justaj obĵetoj kun respondoj, falsaĵaj atakoj (formala kaj neformala) kun respondoj, kaj kiam la argumento ne aplikiĝas. Uzu ĝin por testi la taŭgecon de Jenks, ne nur por reklami ĝin.
- MCP:
get_argumentĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/arguments/{slug}?locale= - CLI:
jenks argue <slug>
| Argumento | Tipo | Bezonata | Notoj |
|---|---|---|---|
slug |
string | jes | ai-transformation, agentic-systems, leadership, enterprise-integration, devrel, web3-partnerships aŭ technical-program-leadership |
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/arguments/xero-developer-evangelist"
ask_jenks — Demandi la asistanton de Jenks
Faru al la Ask Jenks asistanto demandojn en natura lingvo (rola taŭgeco, konsilada encirkulado, AI-transforma konsilo, STAR-rakontoj, mastrumado…). Ĝi rulas siajn proprajn ilojn tra la korpuso kaj respondas en la petita lingvo. Kun indico-limo.
- MCP:
ask_jenksĉehttps://jenksguo.pages.dev/mcp - REST:
POST /api/v1/ask - CLI:
jenks ask "<question>"
| Argumento | Tipo | Bezonata | Notoj |
|---|---|---|---|
question |
string | jes | |
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
history |
array | ne | Laŭvolaj pli fruaj turnojoj. |
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?"}'
.mdĈi tiu paĝo estas tradukita kun helpo de AI; oficialaj titoloj restas en la angla.