APIごとに一つのエントリー。事実には出典を。

提供者、バージョン、仕様書、認証方式を一つのエントリーにまとめ、誰がいつ述べたかを明記します。

暖かな白い紙の上で薄い青色の紙が重なり、縁には丸い穴が整然と並び、下から濃い青色の紙が見えています。

ディレクトリ

条件に使うのは、出典のあるエントリー上の事実です。

認証方式、仕様書、バージョンの状態、関連するMCPサーバーやスキルで絞り込めます。条件を組み合わせても、結果は最後の項目まで表示します。

薄い青色の紙が5枚、門のように並び、濃い青灰色の紙帯が一枚ずつ切り込みを通っています。

APIは更新され、名前が変わり、撤回されることもあります。そのたびに記録し、誰が述べたかを明記します。

8つの構成要素

APIのエントリーは、8つの構成要素でできています。

アイデンティティが常に先頭です。残る7つは、API Hubが15の共通する構成要素から選んだものです。書籍やアニメにも同じ構成要素を使います。

  • アイデンティティ

    名前や識別子が変わっても、エントリーは同じです。以前の表記でも検索できます。

  • 版

    各バージョンを1件ずつ記録し、その時点で実際に公開された内容を残します。

  • 仕様

    認証方式、仕様書、測定結果に、それぞれ出典と日時を付けます。

  • クレジット

    提供する組織と保守する人を役割ごとに記載し、それぞれに専用ページを設けます。

  • 評価

    どのバージョンを、どの質問で評価したかを点数と一緒に明記します。

  • ディスカッション

    ディスカッションスレッドをAPI全体または各バージョンに紐付けます。

  • フォロー

    新バージョンや撤回のお知らせは、設定した通知レベルで届きます。

  • リスト

    API、ソフトウェア、スキルを同じリストに追加し、それぞれにメモを付けられます。

関連

APIを使うもの同士がつながります。

クライアントライブラリ、それを包むMCPサーバー、利用するスキル、提供する組織は、それぞれ固有のエントリーを持ちます。関連付けによって、どちら側からも確認できます。

薄い青色の紙の中央に丸い穴が並び、黄土色、薄緑、濃い青緑の紙帯が縁から伸びて、それぞれの穴を通っています。

APIを選ぶ前に、バージョンと根拠を確認できます。

一つのアカウントでAPIを探して更新をフォローし、連携の経験を次の人に残せます。