文档 / how to
使用 REST API
使用 curl 调用公开、只读的 REST API,获取 Jenks 的简介、条目、翻译、搜索结果和助手答案。
基本用法
- 基础 URL:
https://jenksguo.pages.dev/api/v1 - 公共端点无需认证。除非另有说明,响应为 JSON。
GET端点允许跨域请求。POST /api/v1/ask按 IP 进行限流。- 完整参数列表:REST API reference。
获取简介
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 reference。
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。
.md本页内容在 AI 协助下翻译;官方职位名称保留英文。