本指南介绍如何查看住宅套餐使用了多少流量及其费用。
每个请求都使用您账户后台的个人 API 密钥（如何获取 API 密钥）。在以下示例中，请将 YOUR_API_KEY 替换为您自己的密钥。如需用账户余额支付，请使用 paymentId = 1。
步骤 1 — 获取套餐信息
获取套餐状态和剩余总流量。复制 package_key。
接口地址
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/package
响应
{
"status": "success",
"data": {
"rotation": 60,
"traffic_limit": "7516192768",
"traffic_usage": "10",
"traffic_left": "10",
"package_key": "1234567890abcdefedcb",
"expired_at": "d.m.Y",
"is_active": true,
"tarif_id": 2
},
"errors": []
}
步骤 2 — 获取流量使用
获取套餐的详细流量使用。可按列表登录名或日期范围筛选。
接口地址
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/traffic/details
请求体
名称 | 类型 | 说明 |
packageKey | String | 套餐密钥（来自套餐信息）。 |
login (可选) | String | 可选：按列表登录名筛选。 |
date_start (可选) | String | 可选日期筛选，格式 DD.MM.YYYY。 |
date_end (可选) | String | 可选日期筛选，格式 DD.MM.YYYY。 |
响应
{
"status": "success",
"data": {
"package_key": "1234567890abcdefedcb",
"traffic_usage": "275414777856",
"traffic_usage_formated": "256.5 GB"
},
"errors": []
}
步骤 3 — 获取支出报告
获取支出报告：金额、每 GB 价格及按列表细分。
接口地址
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/consumption
请求体
名称 | 类型 | 说明 |
login (可选) | String | 可选：按列表登录名筛选。 |
date_start (可选) | String | 可选日期筛选，格式 DD.MM.YYYY。 |
date_end (可选) | String | 可选日期筛选，格式 DD.MM.YYYY。 |
响应
{
"status": "success",
"data": {
"package_key": "1234567890abcdefedcb",
"orders_amount": "$557.99",
"orders_bytes_formated": "256.5 GB",
"price_per_gb": "$2.17"
},
"errors": []
}