悟空代理文档中心_API接口文档

切换节点【住宅静态ip】

接口说明

切换节点

接口地址

-/api-v1/changeOrderLine [POST]

请求参数

header参数

参数	类型	必填	说明
Authorization	string	必需	登录鉴权获取的access_token

Body 参数application/json

参数	类型	必填	说明
ids	array	必需	订单编号数组
ids[]	string	必需	订单编号
nodes	array	必需	切换到节点
nodes[]	object	必需	节点信息
nodes[code]	int	必需	城市编号
nodes[server_id]	int	必需	服务器ID
nodes[value]	int	必需	数量

示例:

{
    "ids":[
        "NOR692bbcd19f2a7"
    ],
    "nodes":[
        {
            "code":110100,
            "server_id":2,
            "value":1
        }
    ]
}

返回响应

{
    "code": 200,
    "msg": "切换线路成功",
    "data": [
        {
            "id": "NOR692bbcd19f2a7",
            "username": "q18nz1-1",
            "password": "445566",
            "endtime": "2025-12-01 11:41:05",
            "statime": "2025-11-30 11:41:05",
            "project": "梦幻西游【端游】",
            "province": "北京市",
            "city": "市辖区",
            "isp": "联通"
        }
    ]
}

来自：API接口

设置订单密码【住宅静态ip】

接口说明

设置订单密码

接口地址

-/api-v1/setOrderPassword [POST]

请求参数

header参数

参数	类型	必填	说明
Authorization	string	必需	登录鉴权获取的access_token

Body 参数application/json

参数	类型	必填	说明
ids	array	必需	订单编号数组
ids[]	string	必需	订单编号
pass	string	必需	设置密码，长度4-20

示例:

{
"ids": [
    "NOR692bbcd19f2a7"
]
"pass": 123456
}

返回响应

{
    "code": 200,
    "msg": "设置成功"
}

来自：API接口

获取订单列表【住宅静态ip】

接口说明

获取订单列表

接口地址

-/api-v1/homeResidentialProxy [POST]

请求参数

header参数

参数	类型	必填	说明
Authorization	string	必需	登录鉴权获取的access_token

Body 参数application/json

参数	类型	必填	说明
limit	int	选填	查询数量，默认10
page	int	选填	翻页，默认1
ORDER_NO	string	选填	订单编号查询
ORDER_USERNAME	string	选填	代理账号查询
todyEnd	int	选填	固定值1，查询今日到期订单

示例:

{
    "limit": 0,
    "page": 0,
    "todyEnd": 1,
    "ORDER_NO": "string",
    "ORDER_USERNAME": "string"
}

返回响应

{
    "code": 0,
    "msg": "success",
    "data": [
        {
            "ORDER_NO": "NOR6924167941647",
            "SERVER": "cloud1.wukongdaili.com",
            "PORT": 6100,
            "ORDER_USERNAME": "hv44x0-1",
            "ORDER_PASSWORD": "6666",
            "ORDER_STATIME": "2025-11-24 16:25:29",
            "ORDER_ENDTIME": "2025-12-27 16:25:29",
            "ORDER_BES": "3333",
            "BAND_SPEEDS": 20,
            "PROJECT_NAME": "明日之后",
            "PROVINCE": "内蒙古",
            "CITY": "呼和浩特市",
            "ISP": "电信"
        }
    ]
}

来自：API接口

购买下单【住宅静态ip】

接口说明

获取节点列表

接口地址

-/api-v1/buyFamilyIP [POST]

请求参数

header参数

参数	类型	必填	说明
Authorization	string	必需	登录鉴权获取的access_token

Body 参数application/json

参数	类型	必填	说明
nodes[]	array [object]	必需	购买节点信息
nodes[code]	int	必需	省份或者城市的编号
nodes[value]	int	必需	购买数量
projectId	int	必需	项目ID
bandwidth	int	必需	带宽值
time	int	必需	时间值
timeType	string	必需	时间单位：天卡，月卡
payType	string	必需	固定值：account
ISP	int	必需	运营商：0全部、1电信、2移动、3联通、4其他
areaType	string	必需	地区类型：province、city

示例:

{
    "nodes": [
        {
            "code": 320000,
            "value": 1
        },
        {
            "code": 510000,
            "value": 1
        }
    ],
    "projectId": "5",
    "bandwidth": 5,
    "time": 1,
    "timeType": "月卡",
    "payType": "account",
    "ISP": "0",
    "areaType": "province"
}

返回响应

{
    "code": 200,
    "msg": "购买成功",
    "data": [
        {
            "id": "NOR692bc646b66b8",
            "username": "o7kbnp-1",
            "password": "m9wnvl",
            "endtime": "2025-12-01 12:21:26",
            "statime": "2025-11-30 12:21:26",
            "project": "梦幻西游【端游】",
            "province": "江苏省",
            "city": "泰州市",
            "isp": "电信"
        }
    ]
}

来自：API接口

获取节点列表【住宅静态ip】

接口说明

获取节点列表

接口地址

-/api-v1/getNodeList [POST]

请求参数

header参数

参数	类型	必填	说明
Authorization	string	必需	登录鉴权获取的access_token

Body 参数application/json

参数	类型	必填	说明
projectId	int	必需	项目ID

示例:

{
    "projectId": 1
}

返回响应

{
    "code": 200,
    "msg": "获取节点信息成功",
    "data": {
        "province": [ #按省份
            {
                "code": 440000,
                "name": "广东省",
                "count": 1202, #节点总数量
                "isp": [  #运营商
                    1202, #所有运营商节点数量
                    540, #电信节点数量
                    480, #移动节点数量
                    166, #联通节点数量
                    16 #其他节点数量
                ],
                "value": 0
            }
        ],
        "city": [ #按城市
            {
                "code": 441900,
                "name": "东莞市",
                "count": 124,
                "isp": [
                    124,
                    118,
                    5,
                    1,
                    0
                ],
                "value": 0
            }
        ]
    }
}

来自：API接口

获取产品带宽列表【住宅静态ip】

接口说明

获取产品带宽列表

接口地址

-/api-v1/getProductBandList [GET]

请求参数

header参数

参数	类型	必填	说明
Authorization	string	必需	登录鉴权获取的access_token

Body 参数application/json

参数	类型	必填	说明
productId	int	必需	固定值1

示例:

{
    "productId":1
}

返回响应

{
    "code": 200,
    "msg": "登录成功",
    "data": [3,5,10,20]
}

来自：API接口

获取项目列表【住宅静态ip】

接口说明

获取项目列表

接口地址

/api-v1/getProjectList[GET]

请求参数

Header 参数

参数	类型	必填	说明
Authorization	string	必需	登录授权获取的access_token

示例:

{
    "Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJI****",
}

返回响应

{
    "code": 200,
    "msg": "success",
    "data": [
        {
            "PROJECT_ID": 3,
            "PROJECT_CLASS": "1",
            "PROJECT_NAME": "阿瓦隆【手游】",
            "PROJECT_SORT": 0
        },
        {
            "PROJECT_ID": 4,
            "PROJECT_CLASS": "1",
            "PROJECT_NAME": "5E对战平台【端游】",
            "PROJECT_SORT": 0
        }
    ]
}

来自：API接口

获取用户登录鉴权【住宅静态ip】

接口说明

账号登录获取access_token

接口地址

/api-v1/login[POST]

请求参数

Body 参数application/json

参数	类型	必填	说明
phone	string	必需	手机号码
password	string	必需	登录密码

示例:

{
    "phone": "string",
    "password": "string"
}

返回响应

{
    "code": 200,
    "msg": "登录成功",
    "data": {
        "token_type": "Bearer",
        "expires_in": 604800,
        "access_token": "abcdefg****",
        "refresh_token": "abcdefg****"
    }
}

来自：API接口

文档中心

切换节点【住宅静态ip】

设置订单密码【住宅静态ip】

获取订单列表【住宅静态ip】

购买下单【住宅静态ip】

获取节点列表【住宅静态ip】

获取产品带宽列表【住宅静态ip】

获取项目列表【住宅静态ip】

获取用户登录鉴权【住宅静态ip】

悟空代理IP 免费开通测试