钱包、白名单与查询接口
本页汇总已经开放的通用查询接口，适合账户状态同步、白名单管理和地区数据拉取。
静态 ISP / 独享 DC 的开通、续费、列表见 静态产品 API。
钱包接口
钱包余额
http
POST /v1/wallet/balance
Authorization: Bearer <token>| 字段 | 含义 |
|---|---|
data.balance | 当前可用余额 |
json
{
"code": 0,
"data": {
"balance": 125.5
},
"msg": "success",
"timestamp": 1747037000
}钱包流水
http
POST /v1/wallet/usage_record
Authorization: Bearer <token>| 字段 | 说明 |
|---|---|
page | 页码，默认 1 |
limit | 每页条数，默认 10，最大 100 |
| 返回 | 含义 |
|---|---|
count | 总记录数 |
list[].money | 交易金额绝对值 |
list[].type | 0 入账，1 支出 |
list[].pay_status | 1 已完成 |
json
{
"page": 1,
"limit": 10
}白名单接口
当前用于管理住宅产品的白名单 IP。
新增白名单
http
POST /v1/white_list/add| 字段 | 说明 |
|---|---|
product | 当前使用 1，表示 residential |
ip | 待添加的 IPv4 地址 |
remark | 可选备注 |
json
{
"product": 1,
"ip": "1.2.3.4",
"remark": "office"
}白名单列表
http
POST /v1/white_list/list| 字段 | 说明 |
|---|---|
product | 当前传 1 |
ip | 按单个 IP 精确筛选 |
lock | 0 或 1 |
start_time / end_time | YYYY-MM-DD HH:MM:SS |
| 返回 | 含义 |
|---|---|
total | 条目总数 |
list[].id | 白名单记录 ID |
list[].mark_ip | 原始 IP 字符串 |
list[].ip | IP 的整数表示 |
list[].mark | 备注 |
list[].status | 1 启用 |
json
{
"code": 0,
"data": {
"list": [
{
"id": "7c9f2d5d-1111-2222-3333-444444444444",
"uid": "user-id",
"mark_ip": "1.2.3.4",
"ip": 16909060,
"status": 1,
"lock": false,
"mark": "office",
"created_at": 1747037000,
"updated_at": 1747037000
}
],
"total": 1
},
"msg": "success",
"timestamp": 1747037000
}删除白名单
http
POST /v1/white_list/del| 字段 | 说明 |
|---|---|
product | 当前传 1 |
ips | 必填，逗号分隔，例如 1.1.1.1,2.2.2.2 |
json
{
"product": 1,
"ips": "1.1.1.1,2.2.2.2"
}修改备注
http
POST /v1/white_list/remark| 字段 | 说明 |
|---|---|
product | 当前传 1 |
id | 白名单记录 ID |
remark | 新备注 |
json
{
"product": 1,
"id": "7c9f2d5d-1111-2222-3333-444444444444",
"remark": "server-room"
}动态住宅查询接口
国家/地区查询
http
POST /v1/proxy/domestic_dynamic_area| 字段 | 说明 |
|---|---|
search_word | 按国家名或国家代码搜索 |
| 返回 | 含义 |
|---|---|
continent | 洲代码与洲名称映射 |
country | 按洲分组的国家列表 |
country[].list[].code | 国家代码 |
country[].list[].ip_num | 当前可用区域数量 |
json
{
"search_word": "us"
}城市查询
http
POST /v1/proxy/city_by_code| 字段 | 说明 |
|---|---|
code | 国家代码，例如 us、hk |
州省查询
http
POST /v1/proxy/region_by_city| 字段 | 说明 |
|---|---|
code | 国家代码 |
region | 城市名 |
运营商查询
http
POST /v1/proxy/city_isp| 字段 | 说明 |
|---|---|
code | 国家代码 |
住宅流量余额
http
POST /v1/residential_flow/balance| 返回 | 含义 |
|---|---|
balance | 剩余流量，单位字节 |
expire_time | 最早到期时间戳 |
json
{
"code": 0,
"data": {
"balance": 5368709120,
"expire_time": 1749632000
},
"msg": "success",
"timestamp": 1747037000
}住宅消耗日志
http
POST /v1/residential_flow/consume_log| 字段 | 说明 |
|---|---|
start_time / end_time | YYYY-MM-DD HH:MM:SS |
| 返回 | 含义 |
|---|---|
list[].use | 当日消耗流量，单位字节 |
list[].day | 按天聚合后的时间戳 |
list[].balance | 当前剩余流量快照 |
json
{
"start_time": "2026-04-01 00:00:00",
"end_time": "2026-04-08 23:59:59"
}动态 ISP 查询接口
ISP 地区查询
http
POST /v1/proxy/isp_data_area| 返回 | 含义 |
|---|---|
country[].code | 可用地区代码 |
country[].node | 地区展示名称 |
ISP 流量余额
http
POST /v1/isp_flow/balance返回字段与住宅流量余额一致。
ISP 消耗日志
http
POST /v1/isp_flow/consume_log请求参数与住宅消耗日志一致。
当前限制
- 白名单
product=5仍为预留值，当前未开放。 - 动态住宅与动态 ISP 当前主要提供查询能力，后续会继续补充写接口。
- 白名单删除接口按
ips删除，不是按id删除。