08 整合與 API
08 整合與 API 對照表
第三方整合、API 依賴、管理入口與 owner 缺口總表。
把這份當成第三方平台名錄與管理責任邊界。它不解釋程式怎麼呼叫 API，也不列 secret；它只幫你確認某個整合牽涉哪些專案、誰在管、入口在哪、callback / whitelist / billing 是否會影響維運。
敏感資料交付提醒：本文件中的 05 或 05-environment-variables 指 05-environment-variables_環境變數與金鑰；該文件含 env value / secret 線索，僅做本地交付，不做雲端交付。
這裡確認
- 這個第三方整合牽涉哪些專案
- auth type 是什麼
- 管理入口在哪裡
- owner / vendor / 測試窗口是否已知
- callback、whitelist、billing 是否需要特別注意
這裡不放
- 不重列 env value
- 不重寫 API endpoint 全清單
- 不重寫故障症狀與程式用途
- 不重寫 SDK / query / webhook 實作
先去哪裡
| 情境 | 先看哪裡 |
|---|---|
| 想知道某個整合是誰在管 | 看這份的 整合總表 |
| 想知道 key 值是什麼、程式拿它做什麼 | 回 05-environment-variables |
| 想知道登入平台、2FA、reset、billing | 回 03-access-and-accounts |
| 想知道事故時先判斷什麼 | 回 15-runbooks-and-troubleshooting |
整合總表
| Integration | Projects | Auth Type | Management Entry | Owner / Window | Callback / Whitelist Needed | Billing Impact | Linked Env Doc | Open Gap |
|---|---|---|---|---|---|---|---|---|
| Mahjong backend API | mahjong-system | API endpoint + bearer token | 後端 API 平台 / repo 待確認 | 後端 owner 待確認 | 可能 | 高 | 05-environment-variables | 後端 repo / 文件、production API domain、staging API domain、事故窗口未確認 |
| LINE Login / LIFF / Messaging API | mahjong-system | OAuth app + LIFF ID + Messaging token | LINE Developer | app owner 待確認 | 是 | 中 | 05-environment-variables | channel、LIFF app、webhook URL、token 重發與 2FA holder 未確認 |
| JKOPay | mahjong-system | payment backend + redirect URL | JKOPay 後台 | 金流窗口待確認 | 是 | 高 | 05-environment-variables | 正式 / 測試帳號、redirect URL、退款流程、事故窗口未確認 |
| WordPress / WPGraphQL | matter tintron gonna presotea xinyisheng niceginger hanpoo-ecommerce matterkits/app1 | URL / admin / service access | WordPress admin + hosting | CMS owner / 工程師，待確認 | 視專案而定 | 低 | 05-environment-variables | 各站 owner 與 hosting entry 未完全落地 |
| WooCommerce / zerozero backend | zerozero | admin + service access | WooCommerce / WordPress 後台 | 電商營運 / 工程師，待確認 | 是 | 高 | 05-environment-variables | WooCommerce owner 未確認 |
| zerozero CRM API | zerozero | API endpoint + secret | CRM 平台 | 工程師 / 營運窗口，待確認 | 可能 | 高 | 05-environment-variables | owner、平台入口、secret 管理責任未確認 |
| LINE Login / Google OAuth | zerozero | OAuth app + secret | LINE Developer / Google Cloud | app owner 待確認 | 是 | 低 | 05-environment-variables | callback 管理權與 reset 能力未確認 |
| Newebpay / logistics | zerozero | merchant secret | 藍新後台 / 物流後台 | 金流 / 物流窗口待確認 | 是 | 高 | 05-environment-variables | merchant owner、callback 管理、billing owner 未確認 |
| Contact Form / form endpoints | tintron presotea hanpoo-ecommerce Chlitina-Refining matterkits/app1 等 | REST endpoint / service access | 待確認 | 營運收件窗口待確認 | 可能 | 中 | 05-environment-variables | 收件 owner、正式測試流程、備援路徑未確認 |
| Google Analytics / GTM | matter gonna presotea niceginger matterkits/app1 等 | GA / GTM account | GA / GTM 後台 | 行銷 / 工程師，待確認 | 否 | 中 | 05-environment-variables | account owner 與移轉狀態未確認 |
| Store location API | presotea | service endpoint | STORE_SERVICE_URI 對應平台 | 工程師 / API owner，待確認 | 否 | 中 | 05-environment-variables | API owner 與平台入口未確認 |
| AI API | gonna | endpoint / app secret | 待確認 | 工程師 / 產品窗口，待確認 | 否 | 中 | 05-environment-variables | owner、billing、secret 管理責任未確認 |
| GitHub Actions Storybook deploy | matterkits | GitHub permissions | GitHub Actions | 前端工程師 / repo admin，待確認 | 否 | 低 | 04-infrastructure-and-deployment | workflow owner 與 repo admin 未確認 |
使用方式
- 你先在這裡確認「是哪個平台、誰在管、要不要 callback / whitelist」。
- 接著去對應主文件查細節：
- 值、用途、缺值症狀：
05 - 帳號、登入、2FA、billing：
03 - incident 導航：
15
- 值、用途、缺值症狀：
之後要補的欄位
- owner / backup owner
- 管理平台入口
- 是否有 callback / whitelist 依賴
- billing owner
- vendor 或對外窗口