使用 REST API

基础

• 基础 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。