帳務

本平台向你收費的部分：方案與帳務狀態、預付額度、每日用量、月結單。儲值只能在 Console 進行。

相關指南：閱讀這部分的串接指南

TIP

範例使用〈認證與簽章〉的範例金鑰與時間戳計算簽章，可直接用〈簽章除錯器〉驗算。

帳戶摘要

GET /api/tenant/v1/account

方案、帳務狀態、預付額度、已啟用桌數與配額、本月串流用量、近 7 天平均日費用、預估可用天數與寬限期限。

請求範例

GET /api/tenant/v1/account HTTP/1.1
Host: elite.ewin888.com
X-Api-Key: ek_s_1a_XXXXXXXXXXXXXXXX
X-Timestamp: 1790218800
X-Nonce: ex7b4f461cadf422972ee082
X-Signature: 48cc9647c55affd0452b6da3299d90c2fc5db349858cb5eb4a3073592db40f9a

回應的 data

欄位	型別	說明
plan	string	方案：free 免費展示方案、paid 付費方案。 可能的值：free、paid
state	string	帳務狀態，說明見〈計費說明〉。 可能的值：FREE、PAID、GRACE、DOWNGRADED、SUSPENDED、CLOSED
balanceUsd	string	預付額度餘額（可為負數）。 格式：^-?\d{1,12}(\.\d{1,6})?$
tablesUsed	integer	已啟用桌數。
tablesQuota	integer | null	可啟用桌數；付費方案為 null。
streamGbMonth	string	本月（UTC）串流用量（GB，3 位小數）。
avgDailyUsd7d	string	近 7 天平均每日費用。 格式：^-?\d{1,12}(\.\d{1,6})?$
daysLeft	integer | null	以目前費用估計，預付額度約可再用幾天；沒有費用時為 null。
graceUntil	string (date-time) | null	寬限期截止時間（只在 GRACE 狀態）。

回應範例

{
  "ok": true,
  "data": {
    "plan": "paid",
    "state": "PAID",
    "balanceUsd": "842.315",
    "tablesUsed": 3,
    "tablesQuota": null,
    "streamGbMonth": "412.906",
    "avgDailyUsd7d": "14.672",
    "daysLeft": 57,
    "graceUntil": null
  }
}

錯誤碼

沒有端點專屬的錯誤碼。

所有端點另外都可能回傳共通錯誤（UNAUTHORIZED、IP_NOT_ALLOWED、TENANT_SUSPENDED、RATE_LIMITED、INTERNAL_ERROR…）。

每日用量

GET /api/tenant/v1/account/usage

期間內每天（UTC）的桌·日、串流 GB 與扣款金額。今天尚未扣款，以即時累計顯示。

參數

參數	位置	型別	必填	說明
from	query	string	是	起始日 YYYY-MM-DD（UTC，含）。 格式：^\d{4}-\d{2}-\d{2}$
to	query	string	是	結束日 YYYY-MM-DD（UTC，含）。 格式：^\d{4}-\d{2}-\d{2}$

請求範例

GET /api/tenant/v1/account/usage?from=2026-09-24&to=2026-09-24 HTTP/1.1
Host: elite.ewin888.com
X-Api-Key: ek_s_1a_XXXXXXXXXXXXXXXX
X-Timestamp: 1790218800
X-Nonce: exff963a0ec6342cc030b037
X-Signature: 2cdb9e903b909dc03107a388b3b4319ab00899a4b54e09e0ef37dc8d5219529c

回應的 data

欄位	型別	說明
days	UsageDay[]
days[].day	string	日期 YYYY-MM-DD。 格式：^\d{4}-\d{2}-\d{2}$
days[].tableDays	number	當天計費的桌·日。
days[].streamGb	string	串流用量（GB，3 位小數）。
days[].streamSource	string	串流用量的依據：cdn 串流服務依標籤彙總、client 播放器回報、estimate 估算。 可能的值：cdn、client、estimate
days[].tableFeeUsd	string	桌費。 格式：^-?\d{1,12}(\.\d{1,6})?$
days[].streamFeeUsd	string	串流費。 格式：^-?\d{1,12}(\.\d{1,6})?$

回應範例

{
  "ok": true,
  "data": {
    "days": [
      {
        "day": "2026-09-23",
        "tableDays": 3,
        "streamGb": "18.204",
        "streamSource": "client",
        "tableFeeUsd": "10",
        "streamFeeUsd": "1.638372"
      }
    ]
  }
}

錯誤碼

錯誤碼	HTTP	意義
INVALID_PARAMETER	400	缺少必要欄位，或欄位格式、值不正確；message 會指出是哪個欄位。

所有端點另外都可能回傳共通錯誤（UNAUTHORIZED、IP_NOT_ALLOWED、TENANT_SUSPENDED、RATE_LIMITED、INTERNAL_ERROR…）。

月結單

GET /api/tenant/v1/account/statements

最近 24 期月結單（新到舊），每月 1 日產生上個月的月結單。完整明細在 Console「方案與帳單 → 月結單」。

請求範例

GET /api/tenant/v1/account/statements HTTP/1.1
Host: elite.ewin888.com
X-Api-Key: ek_s_1a_XXXXXXXXXXXXXXXX
X-Timestamp: 1790218800
X-Nonce: exc8d9cee497f5639f4d2bdf
X-Signature: 03b0b872b4c743a0690103d320bb671c93730e8b705d9407ca9622b06459f3d5

回應的 data

欄位	型別	說明
statements	Statement[]
statements[].period	string	期間 YYYY-MM。 格式：^\d{4}-\d{2}$
statements[].openingUsd	string	期初餘額。 格式：^-?\d{1,12}(\.\d{1,6})?$
statements[].chargesUsd	string	扣款合計（負數）。 格式：^-?\d{1,12}(\.\d{1,6})?$
statements[].paymentsUsd	string	付款與加值合計。 格式：^-?\d{1,12}(\.\d{1,6})?$
statements[].closingUsd	string	期末餘額。 格式：^-?\d{1,12}(\.\d{1,6})?$

回應範例

{
  "ok": true,
  "data": {
    "statements": [
      {
        "period": "2026-08",
        "openingUsd": "120",
        "chargesUsd": "-310.52",
        "paymentsUsd": "1000",
        "closingUsd": "809.48"
      }
    ]
  }
}

錯誤碼

沒有端點專屬的錯誤碼。

所有端點另外都可能回傳共通錯誤（UNAUTHORIZED、IP_NOT_ALLOWED、TENANT_SUSPENDED、RATE_LIMITED、INTERNAL_ERROR…）。