REST API を使用する

基本

• ベース 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 です。

1 件のエントリを翻訳付きで取得する

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"

結果は、出典となるエントリまたはドキュメントのスラッグ付き抜粋です。続けて /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 を受け取った場合は、1 分ほど待ってください。

例: 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。