API Hub

舊版本不消失,新版本找得到你。

每一版各自保存發布時的樣子,被撤回也照樣查得到。追蹤一個 API,下一版宣布、上線或撤回時,消息依你設定的方式送到。

六張淺藍色的卡紙依序錯開排成扇形,顏色由淡漸深,頂端的圓孔一張接一張對齊。

版本順序

同一個 API,每一版都有自己的依據。

以虛構的天氣資料 API 示意:第三版改用 API 金鑰,第二版的免認證紀錄仍然保留。紀錄寫錯可附證據更正,之後新增的內容另建下一版。

  • 已撤回

    v1

    免認證。提供者公告,2026/06/18 確認。

  • 可用

    v2

    免認證。提供者版本說明,2026/08/12 確認。

  • 可用

    v3

    API 金鑰。提供者規格文件,2026/10/01 確認。

  • 已宣布

    v4

    API 金鑰。提供者預告,2026/10/19 確認。

示意:天氣資料 API、版本、認證方式、出處與日期都是虛構範例。

五種消息

從宣布到撤回,五種消息各記各的。

同一個版本會經過好幾個時間點。REZICS 不把它們混成一個日期。

  • 宣布

    提供者說會有新版本。這是一則公告,還不是發布。

  • 排定

    公布了預定日期。日期之後有變動,舊的日期也留在歷史裡。

  • 可用

    確認已經可以使用,並附上確認的來源。

  • 延後

    預定日期往後移。延後和取消是兩回事,取消會另外標明。

  • 撤回

    提供者收回這個版本。紀錄保留,狀態改為已撤回。

發布過的版本,紀錄不會被改寫。後來的變更,就是下一個版本。

追蹤

追蹤一個 API,選你要聽多少。

追蹤不必經過對方同意,也不收費。每個追蹤都有一個通知等級,決定哪些消息會進你的收件匣。

  • 全部

    新版本、公告與決定之外,連一般貼文也通知你。

  • 重點

    新版本、公告與決定,才會通知你。

  • 關閉

    一般消息留在追蹤動態;回覆、提及等直接參與仍會通知。

  • 單一版本另設

    想盯緊某一個版本,可以替它另外設定通知。

通知可以送到收件匣、推播或電子郵件摘要。選收的郵件摘要可一鍵退訂。

改版的消息,依你選的方式送到。

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