整合指南
01學習路線
路線之間會互相引用，但不需要依序讀完；每一篇都是獨立的。
還沒接過任何 HSystem 接口，或只想先跑通一次完整流程。
終端機能打通 API、Playground 看得到回應，最後做出一個能登入的頁面。
已經有帳號系統，想多一個登入方式；或正在做原生 App。
開一個開關就能用 Google，不必自己申請 Google Client。
授權頁要求使用者補資料，或 API 少回了某個欄位。
知道每個欄位為什麼拿得到、拿不到。
要做註冊驗證、登入驗證，或任何系統通知信。
寄得出 6 位數驗證碼，也寄得出訂單通知信。
想開始收錢，或需要讓使用者／商品有圖片與檔案。
跑完一次完整結帳（含測試付款），以及一個讀得到的檔案網址。
準備上線，或使用者回報「連不上」。
確認連線通了、看得到用戶、法務頁面備好了。
02依服務分類
每個服務區塊都說明它解決什麼問題、開始前要準備什麼，以及該讀哪幾篇。
託管登入頁與 REST／SDK 註冊登入、OAuth 授權碼 + PKCE、JWT 存取權杖。
以 App + 用戶為鍵的 JSON 資料快取。寫入會合併指定的鍵；白名單留空時不限制鍵名與型別。已授權的聯絡方式仍從帳號投影。
Email 驗證碼與歸屬確認；含一般通知寄送（模板或 HTML）。
網頁 widget（Turnstile／reCAPTCHA v3／Altcha／Cap／mCaptcha）與 App 圖片挑戰 API。
幫你收終端用戶的錢：商品＋結帳走 POST /v1/pay/checkout，只要一筆金額就走 intents。金流商的金鑰由你自己填（平台不代收、不碰錢）。
任意檔案上傳、路徑／前綴管理、內容去重與公開／私密讀取。
產生並託管隱私權政策、服務條款等文件；提供公開 URL 與匯出。
03全部指南
終端機印出 {"ok":true}、Playground 看到真正的回應形狀、本機瀏覽器成功送出一次登入請求。
一次 5 秒就能跑完的健康檢查，確認網路、CORS 與 API 都正常。
一個按下「登入」就跳去 HSystem、登入完回到你頁面，並把 code 換成 access_token 的 HTML 檔。
一顆能貼進任何網站的「以 HSystem 登入」按鈕，跳頁版與 iframe 版各一份。
一個「使用 Google 登入」的開關，以及使用者第一次用 Google 登入時的正確預期。
一個欄位三態都設定正確的 App，你知道哪個欄位會讓使用者多一步補資料。
一個放進 callback.html 的片段：讀出 code、換到 access_token，並把網址清乾淨。
一份能列出 App 用戶的後台查詢（控制台或 curl），看得出誰有效授權、誰已撤銷。
一條走得通的原生登入路徑（SDK exchange 或瀏覽器 PKCE），含 pending 補資料的處理。
一個「寄驗證碼 → 使用者輸入 6 位數 → 確認成功」的流程，寄信那段放在你的後端。
一個「寄一封通知信給使用者」的後端呼叫，以及只負責觸發它的前端按鈕。
一個登入後能讀、能寫使用者自訂資料的頁面，不用自己開資料表。
一組在託管登入／同意頁上真的會出現的隱私權政策與服務條款連結（可以一份託管、一份外鏈）。
一次成功的結帳：拿到 orderId 與 checkoutUrl，付款後訂單變成 paid。
一個真的能打開的檔案網址（public），以及一條需要授權才讀得到的檔案路徑（gated）。
一次通過驗證拿到 captcha_ticket，並在註冊或登入請求裡帶上它。
指南只講「怎麼接起來」；單支接口的參數、回應與錯誤，請看 API 參考。 API 參考
