REST API

鑑權方式: Authorization: Bearer YOUR_API_KEY

GET /api/v1/balance

查詢帳戶本金餘額與獎勵餘額。

{
  "success": true,
  "data": {
    "principal_balance": 100.0,
    "bonus_balance": 10.0,
    "currency": "USD"
  }
}

GET /api/v1/products

查詢從 HeroSMS 同步的商品。可選查詢參數: q.

POST /api/v1/orders

建立單次驗證碼訂單。可傳入單次覆蓋的 callback_url 和 callback_secret。

{
  "country_id": 196,
  "service_code": "wa",
  "operator_code": "singtel",
  "callback_url": "https://example.com/hook",
  "callback_secret": "secret"
}

GET /api/v1/orders/{uuid}

讀取單筆訂單。

POST /api/v1/orders/{uuid}/refresh

主動刷新上游訂單狀態。