跳轉到主要內容
以下路徑均以您的服務地址為前綴。先取得訪問令牌,再通過Authorization請求頭會調用其他接口。請妥善保管帳號密碼和令牌;再次取得令牌後,舊令牌將失效。

1.取得訪問令牌

POST /wapi/token/,請求體為 JSON:
參數說明
username帳號郵箱,必填
passwd帳號密碼,必填
成功時,回應的results.token即為訪問令牌:
購買過動態 GB、優質動態 GB 套餐或兌換過動態流量的帳號可取得令牌。此接口有訪問頻率限制,收到 HTTP 429 時請稍後重試。

2.檢查動態 GB 流量消耗

GET /wapi/consume/dynamic/chart/
查詢參數說明
suname子帳戶用戶名;不傳或傳空值時查詢主帳戶
st開始時間,Unix 秒
et結束時間,Unix 秒
示例:GET /wapi/consume/dynamic/chart/?suname=sub_account&st=1735689600&et=1735776000 曾購買動態 GB 或動態 GB 高級套餐,或兌換過動態流量的帳號可調用此接口。

3.檢查優質動態 GB 流量消耗

GET /wapi/consume/premium/chart/ 請求頭、查詢參數及回應格式與動態 GB 流量消耗接口相同。示例:GET /wapi/consume/premium/chart/?suname=sub_account&st=1735689600&et=1735776000。 曾購買優質動態 GB 套餐的帳號可調用此接口。 兩個流量接口均遵循以下時間與返回規則:
  • st、et任一未提供或不大於 0 時,查詢帳號時區的當天零點至當前時間。
  • st 与 et相同時,查詢從該時間起的一天;開始時間晚於結束時間將返回參數錯誤。
  • results按時間順序排列的數據點;period是時間段,timestamp是對應的 Unix 秒,total_traffic_count是該時間段消耗的流量(字节)。無消耗的時間段回傳 0。
響應示意(數值僅用於說明格式):

4.批量創建兌換碼(CDK)

POST /wapi/cdk/create/
參數說明
cdk_type必填:1 動態流量、2 IP 數量、3 移動流量
flow類型 1、3 必填;每個兌換碼的流量,單位 GB,範圍 1~10000
ip類型 2 必填;每個兌換碼的 IP 數量,範圍 1~10000
day類型 1、3 的有效天數
num必填;生成數量,範圍 1~10000
動態流量兌換碼範例:
成功時,results是生成的兌換碼列表;其中Cdk是兌換碼,Type是類型,Flow是字节数,Ip是 IP 數量,Days是有效天數:
請確保帳戶擁有足夠的對應資源;資源不足時整批創建會失敗。請勿同時提交相同的創建請求。此接口有訪問頻率限制,收到 HTTP 429 時請稍後重試。

常见错误

code含義
41001查詢參數錯誤,或指定的子帳戶不存在
41003帳號或密碼錯誤
41005當前帳號不具備相應接口的使用資格
41010令牌無效(HTTP 403)
40049創建兌換碼的參數不合法
40052創建兌換碼失敗,例如對應資源不足
40901相同的創建請求正在處理中
請同時檢查回應中的 code:部分業務錯誤會以 HTTP 200 返回。