账务

本平台向你收费的部分：方案与账务状态、预付额度、每日用量、月结单。充值只能在 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…）。