使用 REST API

基本資訊

• 基底 URL：https://jenksguo.pages.dev/api/v1
• 公開端點不需驗證。除非另有說明，回應為 JSON。
• GET 端點允許跨來源請求。POST /api/v1/ask 依每個 IP 限速。
• 完整參數列表： REST API 參考。

取得簡介

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

同一份簡介也可作為檔案取得：https://jenksguo.pages.dev/brief.md。

列出條目並套用篩選

所有 Web3 工作：

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

僅社群與治理相關職務：

curl -s "https://jenksguo.pages.dev/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.pages.dev/api/v1/entries/xero-developer-evangelist?locale=zh"

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

搜尋

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

結果為段落，並附來源條目或文件的 slug。接著可請求 /api/v1/entries/{slug}。

讀取文件

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

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

詢問助理

curl -s https://jenksguo.pages.dev/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.pages.dev/api/v1/entries?lens=developer-advocate" \
  | jq -r '.entries[] | "- \(.title) — \(.org) (\(.period)): \(.summary)"'

靜態替代方案

若只需要檔案，以下資源的結構固定且容易快取： /llms.txt、/llms-full.txt、/experience.json、/resume.json 和 /openapi.json。