API Hub

每個分數,都說清楚評的是哪一版。

評一個 API,要先說清楚問的是哪個問題、針對哪一版。分數旁邊附上人數與分布;討論、清單與社群,也都圍著同一個條目。

評分

一個分數,由五件事決定。

示意:問「文件清不清楚」,用五分制,針對第三版,由全站的人給分。

  • 問題

    評的是哪個問題。問題不同的分數,從不合在一起算。

  • 量表

    用幾分制、每一分代表什麼,事先講明。

  • 對象

    評的是哪一版。這一版的分數,不會算進別的版本。

  • 群體

    由哪一群人給分,標籤就寫在分數旁邊。

  • 人數與分布

    每個分數都附上評分人數與分布。人數太少時,只列出人數與分布,不算平均。

串接遇到的問題,接在那一版底下討論。換了版本,舊版的討論仍留在舊版底下。

清單

一個專案用到的東西,放進一份清單。

清單不分種類:API、用戶端程式庫、MCP 伺服器與技能可以排在一起,每項寫上一句註記。清單有自己的公開範圍,可以排序,也能匯出。

  • API

    天氣資料 API

    預報資料的來源

  • API

    地圖圖磚 API

    畫面上的底圖

  • 軟體

    用戶端程式庫

    從程式裡呼叫天氣資料 API

  • MCP 伺服器

    天氣 MCP 伺服器

    讓 AI 代理查詢天氣

  • 技能

    行程整理技能

    依天氣調整每天的行程

示意:一個虛構專案的清單,名稱都是例子。

Realm 與 Zone

為一類 API,架一個 Zone。

社群可以成立 Realm,訂自己的規則,用自己的方式解讀條目上的事實。也可以架一個 Zone,做成專門的 API 目錄網站,資料仍來自同一張圖。

每個分數與討論,都說清楚對象。

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