每個 API 一個條目,每筆事實都有出處。

提供者、版本、規格文件與認證方式整理在同一個條目,誰說的、什麼時候說的都寫明。

暖白紙面上,幾張淺藍色的紙交疊,邊上打著一排排整齊的圓孔,底下露出一張深藍色的紙。

目錄

每一個條件,都是條目上一筆有來源的事實。

認證方式、規格文件、版本狀態,還有它連著哪些 MCP 伺服器與技能,都能拿來篩選。可用條件組合篩選,結果一路列到最後一筆。

五張淺藍色的紙片像閘門一樣立成一排,一條深灰藍的紙帶依序穿過每一張紙上的切口。

API 會改版、會改名,也會撤回。條目把每一次都記下來,並寫明是誰說的。

八個部件

一個 API 條目,由八個部件組成。

身分永遠排在第一個。其他七個部件,是 API Hub 從十五個共用部件裡挑出來的,書與動畫用的也是同一套。

  • 身分

    改了名稱或換了識別碼,條目還是同一個,舊的寫法照樣查得到。

  • 版本

    每一版各是一筆紀錄,寫的是當時實際發布的內容。

  • 規格

    認證方式、規格文件與量測結果,各自附上來源與時間。

  • 製作人員

    提供的組織與維護的人依角色列名,各有自己的頁面。

  • 評分

    分數旁邊寫明評的是哪一版、問的是哪個問題。

  • 討論

    討論串接在整個 API 或某一版底下。

  • 追蹤

    新版本與撤回的消息,依你設定的等級送達。

  • 清單

    一份清單可以同時放 API、軟體與技能,每項附註記。

周邊

建在 API 上的東西,彼此連在一起。

用戶端程式庫、包裝它的 MCP 伺服器、用到它的技能,還有提供它的組織,都是有身分的條目。關聯把它們連起來,從哪一端都看得到。

一張淺藍色的紙中央打著一排圓孔,土黃、淺綠與深青三條紙帶從邊緣伸來,各自穿進一個孔。

挑一個 API 之前,先看它的版本與證據。

用一個帳號找 API、追蹤改版,也把串接的經驗留給下一個人。