cURL
curl --get 'https://miyaip.com/api/UserIsps/PageList' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <YOUR_TOKEN>' \
--data-urlencode 'PageNo=1' \
--data-urlencode 'PageSize=10' \
--data-urlencode 'IspType=-1' \
--data-urlencode 'Vid=all'const params = new URLSearchParams({
"PageNo": "1",
"PageSize": "10",
"IspType": "-1",
"Vid": "all"
});
const url = `https://miyaip.com/api/UserIsps/PageList?${params}`;
const response = await fetch(url, {
method: 'GET',
headers: {
"Accept": "application/json",
"Authorization": "Bearer <YOUR_TOKEN>"
},
});
const result = await response.text();
console.log(result);import requests
url = "https://miyaip.com/api/UserIsps/PageList"
headers = {
"Accept": "application/json",
"Authorization": "Bearer <YOUR_TOKEN>"
}
params = {
"PageNo": 1,
"PageSize": 10,
"IspType": -1,
"Vid": "all"
}
response = requests.get(url, headers=headers, params=params, timeout=30)
response.raise_for_status()
print(response.text){
"code": 200,
"message": "Success",
"body": {
"pageNo": 1,
"pageSize": 10,
"totalPage": 1,
"totalRows": 1,
"records": [
{
"id": 12001,
"ipNo": "<IP_NO>",
"ispType": 0,
"ip": "proxy.example:10000:user:********",
"directIp": "203.0.113.10:10000:user:********",
"ispLocation": "US",
"expireTime": "2026-12-31 23:59:59"
}
]
}
}{
"code": 500,
"message": "Invalid request",
"body": null
}代理资产
MiyaIP 住宅资产 API:筛选与分页查询代理 IP
使用 Bearer Token 分页查询 MiyaIP 住宅代理资产,设置状态、产品类型、地区、关键词与排序,并读取账户已购 IP。
cURL
curl --get 'https://miyaip.com/api/UserIsps/PageList' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <YOUR_TOKEN>' \
--data-urlencode 'PageNo=1' \
--data-urlencode 'PageSize=10' \
--data-urlencode 'IspType=-1' \
--data-urlencode 'Vid=all'const params = new URLSearchParams({
"PageNo": "1",
"PageSize": "10",
"IspType": "-1",
"Vid": "all"
});
const url = `https://miyaip.com/api/UserIsps/PageList?${params}`;
const response = await fetch(url, {
method: 'GET',
headers: {
"Accept": "application/json",
"Authorization": "Bearer <YOUR_TOKEN>"
},
});
const result = await response.text();
console.log(result);import requests
url = "https://miyaip.com/api/UserIsps/PageList"
headers = {
"Accept": "application/json",
"Authorization": "Bearer <YOUR_TOKEN>"
}
params = {
"PageNo": 1,
"PageSize": 10,
"IspType": -1,
"Vid": "all"
}
response = requests.get(url, headers=headers, params=params, timeout=30)
response.raise_for_status()
print(response.text){
"code": 200,
"message": "Success",
"body": {
"pageNo": 1,
"pageSize": 10,
"totalPage": 1,
"totalRows": 1,
"records": [
{
"id": 12001,
"ipNo": "<IP_NO>",
"ispType": 0,
"ip": "proxy.example:10000:user:********",
"directIp": "203.0.113.10:10000:user:********",
"ispLocation": "US",
"expireTime": "2026-12-31 23:59:59"
}
]
}
}{
"code": 500,
"message": "Invalid request",
"body": null
}分页读取当前认证账户的住宅代理资产。此接口查询已有资产,不负责购买、续费或生成代理。
查询已有资产
- 从登录接口取得 Token,填写为 Bearer 凭据。
- 按下方参数设置分页,以及所需的状态、产品类型、地区、关键词或排序筛选。
- 发送后检查 HTTP 状态与业务结果,核对当前页和总数,再使用相同筛选读取下一页。
Vid 与 IspType 使用文档列出的枚举。需要 IspType=0 时保留该值;零是有效选项,不是空字段。排序使用文档中的字段,以及 asc 或 desc。不填可选筛选与明确传入筛选值不同。
表单分页范围来自当前公开界面。后台管理已购 IP 见静态住宅快速开始,错误处理见 API 响应处理说明。
在线调试
来源:官方住宅资产接口参考。授权
使用登录响应中的 token,发送 Authorization: Bearer 请求头。Token 有效期和刷新方式未在来源中说明。
查询参数
从 1 开始的页码。
示例:
1
每页返回的记录数。
示例:
10
-1 查询全部;0 为独享;1 为共享。
可用选项:
-1, 0, 1 示例:
-1
代理资产状态筛选。
可用选项:
all, new, valid, exp, expiringsoon 示例:
"all"
可选的 ISP 地区筛选。
按 IP 或相关标识搜索。
可按创建时间或过期时间排序。
可用选项:
sysCreateTime, expireTime 可选。不传时沿用当前调用方的默认升序行为。
可用选项:
asc, desc