REST API を使用する

基本

• ベース URL: https://jenksguo.xyz/api/v1
• 公開エンドポイントには認証は不要です。特記がない限り、レスポンスは JSON です。
• GET エンドポイントはクロスオリジン要求を許可します。POST /api/v1/ask は IP ごとにレート制限されます。
• パラメータの全一覧は REST API reference をご参照ください。

ブリーフを取得する

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

同じブリーフはファイルとして https://jenksguo.xyz/brief.md でも入手できます。

エントリ一覧をフィルタして取得する

すべての Web3 関連の実績:

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

Community およびガバナンスのロールのみ:

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"

検索結果は、出典となるエントリまたはドキュメントのスラッグ付き抜粋です。続けて /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 が返った場合は、1 分待ちます。

例: jq でショートリスト用ノートを作成する

レスポンスのフィールドは REST API reference に記載されています。

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。