Authorization請求頭會調用其他接口。請妥善保管帳號密碼和令牌;再次取得令牌後,舊令牌將失效。
1.取得訪問令牌
POST /wapi/token/,請求體為 JSON:
| 參數 | 說明 |
|---|---|
username | 帳號郵箱,必填 |
passwd | 帳號密碼,必填 |
results.token即為訪問令牌:
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是有效天數:
常见错误
code | 含義 |
|---|---|
41001 | 查詢參數錯誤,或指定的子帳戶不存在 |
41003 | 帳號或密碼錯誤 |
41005 | 當前帳號不具備相應接口的使用資格 |
41010 | 令牌無效(HTTP 403) |
40049 | 創建兌換碼的參數不合法 |
40052 | 創建兌換碼失敗,例如對應資源不足 |
40901 | 相同的創建請求正在處理中 |