API 金鑰與經銷分站
重點
在開發者工作區建立 API 金鑰，即可從自己的系統列出服務、下單及查詢狀態，訂單由你的錢包扣款。經銷分站是為你自己的顧客而設的獨立網站，透過同一套 API 向你的 Boostsy 帳戶採購。分站須提出申請，並需要你自行準備網域及主機。
API 金鑰
- 在帳戶開啟開發者。
- 選擇建立金鑰並命名。金鑰只會顯示一次，請即時複製。
- 以 Bearer token 方式帶上金鑰，向 API 端點發送請求。
可用操作：services、balance、add、status、refill、refill_status 及 cancel。每張訂單請附上 Idempotency-Key 標頭，重試時便不會建立重複訂單。完整說明見開發者頁面。
金鑰可動用你的餘額。請存放在伺服器，每項整合使用獨立金鑰，並撤銷任何外洩的金鑰。
API 價格
services 清單會回傳你的帳戶在每項服務的價格。精選方案採用零售價格尾數，所以計算費用時應以訂單狀態回應內的實際扣款為準，而不是單靠每千個的價格。
經銷分站
經銷分站是你自己的獨立安裝，擁有自己的顧客、付款及品牌。它以屬於你帳戶的金鑰向 Boostsy 下單，只會動用你的錢包。
- 在帳戶開啟分站並提交網域。
- 審核後，下載私人部署套件。
- 在自己的主機部署，並設定網域、HTTPS 及電郵。
- 為 Boostsy 錢包增值；顧客的付款則留在你的分站。
提出申請並不代表分站已經上線，須待你完成部署及測試。主機、DNS 及付款設定均由你負責。
與客戶合作的做法，可參考整理客戶訂單的實用流程。