使用 REST API

基本資訊

• Base URL: https://jenksguo.xyz/api/v1
• 公開端點無需驗證。除非另有說明，回應為 JSON。
• GET 端點允許跨來源請求。POST /api/v1/ask 依 IP 進行速率限制。
• 完整參數清單：REST API 參考。

取得簡介

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

相同的簡介也可作為檔案於 https://jenksguo.xyz/brief.md 取得。

列出條目（可篩選）

所有 Web3 相關工作：

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

僅社群與治理相關職務：

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

可合併篩選：?tag=consulting&lens=ai-transformation-consultant。可用標籤有 it、engineering、 ai、devrel、web3、business、marketing、consulting、hospitality、community 與 creative。

取得單一條目（含翻譯）

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

支援的語系：en（預設）、zh、zh-hant、ja、fr、es、eo。正式職稱與 組織名稱在所有語系中皆維持英語。

搜尋

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

結果為段落，並附上其來源條目或文件的 slug。可再呼叫 /api/v1/entries/{slug} 取得詳細內容。

讀取文件

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

文件清單：profile、credentials、capabilities、talks、thinking。

詢問助理

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

可用 "history": [{"role": "user", "content": "…"}, {"role": "assistant", "content": "…"}] 加入先前對話輪次。 若收到 429，請稍候一分鐘。

範例：使用 jq 建立精簡筆記

回應欄位列於 REST API 參考。

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

靜態替代方案

若只需檔案，以下格式固定且易於快取： /llms.txt、/llms-full.txt、/experience.json、/resume.json 與 /openapi.json。