API Hub

呼び出す前に、必要な情報を確認できます。

認証方法、仕様書の場所、測定結果をバージョンごとに記録し、誰がいつ述べたかを明記します。

薄い青色の厚紙が3枚重なり、それぞれの隅に四角い空押しがあります。下から濃い青灰色の紙が見えています。

バージョンに記録

認証方式と仕様書を各バージョンに記録します。

同じAPIでも、バージョンによって認証方式が異なる場合があります。事実は各バージョンに記録し、出典を明記します。

  • 認証方式

    認証不要、APIキー、ユーザー認証を各バージョンに記録します。新バージョンで認証方式が変わっても、旧バージョンの記録はそのまま残ります。

  • 仕様書

    仕様書の掲載場所、提供者、確認日をエントリーに記録します。

  • 測定

    測定結果には必ず、指標、方法、条件、単位、日時を添えます。

  • 出典

    各事実について、提供者の情報、公的な情報源からのインポート、コミュニティでの測定のどれかを明記します。インポートした情報には出典とライセンスへのリンクを添えます。

測定と評価は別のものです。評価は人々の意見です。測定は、どのような条件で何を測ったかを示します。

測定

測定記録では、まず5つの情報を確認します。

指標、方法、条件、単位、日時を確認してください。比較する際は、結果、対象、対象範囲も確認します。

  • 測定指標

    何を測定したか。

  • 測定方法

    どの方法で測定したか。

  • 条件

    どのような条件で測定したか。

  • 単位

    数値の単位。

  • 日時

    測定日です。古い結果には当時の日付を付けます。

同じ指標の結果を履歴として蓄積し、ほかのAPIと同じ比較表に並べられます。

不足している情報

不明、ゼロ、該当なしは、それぞれ別の状態です。

未測定の値は不明とし、ゼロとは記録しません。該当しない指標も、情報不足とは区別します。不足している情報を誤解を招く評価に変えることはありません。

認証方法を確認してから連携を始められます。

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