Changelog
文件站與公開 API 的變更。只記錄你會感覺得到的事。
新手軌道:先跑通,再登入
- 新增〈第一次呼叫(30 分鐘)〉:curl 打通 → Playground 模擬 → 在自己的電腦開一個 HTML,全程不需要公開網域。
- 新增〈收款:從商品到結帳〉、〈上傳與讀取檔案〉、〈人機驗證〉三篇最短指南。
- 所有複製的 curl/程式範例改成固定使用 https://api.hsystem.halphastech.com,不再出現 localhost。
- Reference 與側欄的接口數只算 /v1 本尊,公開平面鏡像改成預設收起的「同一支接口的另一個網址」。
- 指南列表不再顯示與網址對不上的編號;改以學習路線的步驟序號呈現。
- 首頁第一屏從「360 個端點」改成「先挑一件現在要做的事」。
- Reference 服務頁新增「先打這幾支」精選,不用在 30 支接口裡自己找主幹。
- Changelog 開始有內容(就是這一頁)。
- 新增〈術語小辭典〉:App、client_id、intent、grant 這些名詞各一句話,並連到對應頁面。
- 新增〈範例與 AI〉:可下載的純前端範例 zip(改一行 client_id 就能跑)、每個服務的 SKILL.md 下載入口、OpenAPI 產生型別的做法。
Playground 改兩段式瀏覽
- 先選服務(15 張卡)→ 再選端點;沒選時直接顯示「快速開始」四支最常用接口。
- 端點卡標示需要的憑證(免憑證/App 金鑰/使用者 token),選之前就知道要準備什麼。
- /api/public 鏡像預設隱藏,另給一個開關。
- 語言切換加入過場動畫,並尊重 prefers-reduced-motion。
八語系介面
- 文件站導覽、按鈕、表格標題與服務說明支援 8 種語系。
- 指南正文目前仍為繁體中文;切換語系時會明確提示,不再讓人以為翻譯壞掉。
救生頁:憑證與錯誤碼
- /credentials 說明四種憑證分別放哪裡、外洩會怎樣。
- /errors 以錯誤 code 導向處理方式,而不是只列 HTTP 狀態碼。

