Skip to main content
JGJenks Guo

Dokumentaro / how to

Uzi la REST API

Voku la publikan, nur-legan REST API per curl por elpreni la resumon de Jenks, enskribojn, tradukojn, serĉrezultojn kaj respondojn de la asistanto.

Bazoj

  • Baza URL: https://jenksguo.xyz/api/v1
  • Neniu aŭtentigo por publikaj finpunktoj. Respondoj estas JSON krom se alie indikite.
  • GET finpunktoj permesas interoriginajn petojn. POST /api/v1/ask estas ritmolimitita por ĉiu IP.
  • Plenaj listoj de parametroj: REST API-referenco.

Akiri la resumon

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

La sama resumo disponeblas kiel dosiero ĉe https://jenksguo.xyz/brief.md.

Listigi enskribojn, filtrite

Tuta Web3-laboro:

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

Nur roloj pri komunumo kaj regado:

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

Kombinu filtrilojn: ?tag=consulting&lens=ai-transformation-consultant. Etikedoj estas it, engineering, ai, devrel, web3, business, marketing, consulting, hospitality, community kaj creative.

Akiri unu enskribon, tradukite

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

Subtenataj lokaloj: en (defaŭlta), zh, zh-hant, ja, fr, es, eo. Oficiaj labortitoloj kaj nomoj de organizoj restas en la angla en ĉiu lokalo.

Serĉi

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

Rezultoj estas tekstofragmentoj kun la slug de la enskribo aŭ dokumento, el kiu ili venas. Sekvu per /api/v1/entries/{slug}.

Legi dokumenton

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

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

Demandi la asistanton

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

Aldonu pli fruajn turnojn per "history": [{"role": "user", "content": "…"}, {"role": "assistant", "content": "…"}]. Se vi ricevas 429, atendu unu minuton.

Ekzemplo: konstrui mallonglistan noton per jq

Respondaj kampoj estas listigitaj en la REST API-referenco.

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

Statikaj alternativoj

Se vi bezonas nur dosierojn, ĉi tiuj neniam ŝanĝas formon kaj bone kaŝmemoriĝas: /llms.txt, /llms-full.txt, /experience.json, /resume.json kaj /openapi.json.

.mdĈi tiu paĝo estas tradukita kun helpo de AI; oficialaj titoloj restas en la angla.