接口文档 | OwlProxy API

简介

本文档为您提供具体的 API 描述、语法、参数说明及示例等。

OpenAPI 接口列表

静态IP服务

获取代理类型

接口地址

/owlproxy/api/openApi/vcProxyShop/getProxyTypeList

请求方式

GET

请求数据类型

application/json

请求Query参数

参数名	示例值	参数类型	参数描述
proxyMode	1	Integer	静态:1 动态:2 移动代理:3 不填写全部返回

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data		Object[]	状态码
├─id	1	Long	类型id
├─typeName	静态IPV6/32代理	String	类型名称
├─typeIllustrate	更纯净的代理地址，高隐蔽性、高性价比，适用于部分平台	String	描述

响应示例

{
    "msg": "success",
        "code": 200,
        "data": [
        {
            "defSelected": 0,
            "typeName": "静态IPV6/32代理",
            "typeIllustrate": "更纯净的代理地址，高隐蔽性、高性价比，适用于部分平台",
            "typeMarkColor": "",
            "id": 4,
            "sort": 1,
            "typeMark": ""
        }
    ],
        "ts": 1751179652664
}

获取静态IP地区

接口地址

/owlproxy/api/openApi/vcProxyGood/getProxyCountry

请求方式

GET

请求数据类型

application/json

请求Query参数

参数名	示例值	参数类型	参数描述
proxyType	1	Integer	代理类型

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data		Object[]	状态码
├─countryCode	US	String	地区编码
├─countryName	美国	String	地区名称

请求示例

?proxyType=4

响应示例

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "countryCode": "US",
            "countryName": "美国"
        },
    ],
    "ts": 1749808527634
}

获取静态IP质量选项

接口地址

/owlproxy/api/openApi/vcProxyGood/proxyIdType

请求方式

GET

请求数据类型

application/json

请求Query参数

参数名	示例值	参数类型	参数描述
proxyType	2	Integer	代理类型

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data		Object[]	状态码
├─msg	IP净度高，满足大部分场景需求	String	描述
├─name	普通	String	名称
├─proxyIdType	ord	String	类型

请求示例

?proxyType=4

响应示例

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "countryCode": "US",
            "countryName": "美国"
        },
    ],
    "ts": 1749808527634
}

获取静态IP服务商

接口地址

/owlproxy/api/openApi/vcProxyShop/getProxyShopList

请求方式

POST

请求数据类型

application/json

请求Body参数

参数名	示例值	参数类型	参数描述
countryCode	US	String	地区编码
proxyType	4	String	代理类型
proxyIdType	ord	String	IP质量

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data		Object[]
├─proxyMaxNum	3	Integer	单次最大购买的IP数量
├─proxyName	A区	String	服务商名称
├─icon		String	图标地址
├─proxySort	1	Integer	排序
├─proxyId	2	Integer	服务商ID

请求示例

{
    "countryCode": "US", 
    "proxyType": 4, 
    "proxyIdType": "ord"  
}

响应示例

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "proxyMaxNum": 100,
            "proxyName": "A区",
            "icon": "https://file.vmoscloud.com/upload/880d10ccc89f3371b9274aed7f6ca139.png",
            "proxySort": 1,
            "proxyId": 2
        },
        {
            "proxyMaxNum": 3,
            "proxyName": "B区",
            "icon": "https://file.vmoscp.com/agent/mallApp/icon/proxyline-icon.png",
            "proxySort": 2,
            "proxyId": 1
        }
    ],
    "ts": 1749809117448
}

获取静态IP套餐

接口地址

/owlproxy/api/openApi/vcProxyGood/proxyGoodList

请求方式

GET

请求数据类型

application/json

请求Query参数

参数名	示例值	参数类型	参数描述
proxyShopId	1	Integer	服务商ID
countryCode	US	Integer	地区
proxyType	2	Integer	代理类型
proxyIdType	ord	String	IP质量

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data		Object[]
├─proxyGoodName	1天	String	套餐名称
├─proxyGoodId	5	Integer	套餐ID
├─proxyGoodOldPrice	69	Integer	原价
├─proxyGoodTime	1440	String	套餐时间(分钟)
├─proxyGoodPrice	61	Integer	套餐价格
├─proxyGoodreNewalFee	61	Integer	续费价格
├─proxyGoodType	2	Integer	服务商ID
├─autoRenew	true	Boolean	是否支持自动续费

请求示例

?proxyShopId=2&countryCode=US&proxyType=2&proxyIdType=ord

响应示例

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "proxyGoodName": "1天",
            "proxyGoodId": 5,
            "proxyGoodOldPrice": 69,
            "updateTime": 1749473960000,
            "proxyGoodTime": 1440,
            "proxyGoodRemark": "88折",
            "proxyGoodType": 2,
            "createTime": 1728889525000,
            "proxyGoodreNewalFee": 61,
            "autoRenew": true,
            "proxyGoodPrice": 61
        }
    ],
    "ts": 1749901953306
}

购买静态IP套餐

接口地址

/owlproxy/api/openApi/vcProxyGood/createProxyOrder

请求方式

POST

请求数据类型

application/json

请求Body参数

参数名	示例值	参数类型	参数描述
proxyGoodId	1	Integer	套餐ID
num	1	Integer	数量
country	US	String	地区
proxyShopId	1	Integer	服务商ID
autoRenew	false	Integer	自动续费是: true 否: false
backUrl	"http://localhost:8080/callback"	String	回调URL

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳

请求示例

{
    "proxyGoodId": 1, // 套餐ID
    "num": 1, // 数量
    "country": "US", // 地区
    "proxyShopId": 1, // 服务商ID
    "autoRenew": false // 自动续费 是: true 否: false
}

响应示例

{
    "msg": "success",
    "code": 200,
    "ts": 1745823575860
}

根据订单号获取IP信息

接口地址

/owlproxy/api/openApi/vcProxy/queryByorderIdList

请求数据类型

application/json

请求Body参数

参数名	示例值	参数类型	参数描述
orderIds	["Owl-PROXY176881932132132132132213"]	JSONArray / String[]	要查询的订单ID列表（支持批量查询）

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1768879288540	Integer	时间戳（毫秒）
data		Object[]	代理订单数据列表
├─ orderAmount	175	Integer	订单金额
├─ orderId	Owl-PROXY176881923201484268	String	订单ID
├─ proxyInfoList		Object[]	该订单下的代理信息列表
│ ├─ ip	45.196.253.34	String	代理IP地址
│ ├─ port	9481	Integer	代理端口
│ ├─ username	T5c2u2E2z0o5	String	代理用户名
│ ├─ password	H6k9o5N1J7f5	String	代理密码
│ ├─ expireTime	2026-02-19 14:13:33	String	到期时间

请求示例

{
    "msg"
:
    "success",
        "code"
:
    200,
        "data"
:
    [
        {
            "orderAmount": 175,
            "orderId": "Owl-PROXY176881232321321312",
            "proxyInfoList": [
                {
                    "ip": "45.196.233.11",
                    "port": 1231,
                    "username": "T5c2u2E23213",
                    "password": "H6k9o5N32133",
                    "expireTime": "2026-02-19 14:13:33",

                }
            ]
        },
        {
            "orderAmount": 175,
            "orderId": "Owl-PROXY1768819212323132",
            "proxyInfoList": [
                {
                    "ip": "45.196.123.123",
                    "port": 1231,
                    "username": "H5L6q8b12321",
                    "password": "w5X8w1232131",
                    "expireTime": "2026-02-19 14:13:33",

                }
            ]
        }
    ],
        "ts"
:
    1768879288540 /* 2026-01-20 11:21:28 */
}

获取静态IP列表

接口地址

/owlproxy/api/openApi/vcProxy/queryList

请求方式

POST

请求数据类型

application/json

请求Body参数

参数名	示例值	参数类型	参数描述
current	1	Integer	当前页
size	10	Integer	分页大小
proxyName	129	String	备注
proxyBuyStatusId	1	Integer	状态即将过期: 1 已过期: 2 正常: 3

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data
├─ total	10	Integer	总记录数
├─ pages	10	Integer	总页数
├─ records		Object[]	记录列表
│ ├─ proxyId	1	Integer	id
│ ├─ proxyName	1	String	备注
│ ├─ proxyGoodId	1	Integer	套餐ID
│ ├─ shopName	B区	String	服务商
│ ├─ proxyPort	63999	Integer	端口
│ ├─ account	*****	String	账号
│ ├─ password	*****	String	密码
│ ├─ modifyTime	1749909233000	Timestamp	修改时间
│ ├─ expectedExpireTime	1749909233000	Timestamp	过期时间
│ ├─ proxyBuyStatusId	1749909233000	Timestamp	状态
│ ├─ proxyHost	45.193.43.243	String	Host
│ ├─ renewGood	false	Boolean	是否自动续费
│ ├─ autoRenewGoodId	1	Integer	自动续费套餐id
│ ├─ proxyHttpPort	7778	Integer	Http端口号

请求示例

{
    "current": 1, // 当前页
    "size": 20, // 分页大小
    "proxyName": "", // 备注
    "proxyBuyStatusId": "" // 状态 即将过期: 1  已过期: 2  正常: 3
}

响应示例

{
    "msg": "success",
    "code": 200,
    "data": {
        "current": 1,
        "total": 3,
        "pages": 1,
        "optimizeCountSql": true,
        "size": 20,
        "records": [
            {
                "proxyGoodId": 1,
                "proxyName": "45.192.43.243",
                "shopName": "B区",
                "password": "NedyYDqp",
                "modifyTime": 1749909233000,
                "expectedExpireTime": 1751199998,
                "proxyShopId": 1,
                "proxyBuyStatusId": 3,
                "proxyType": 1,
                "autoRenewGoodId": 1,
                "proxyHost": "45.192.128.243",
                "userId": 997875,
                "proxyBuyStatus": "正常",
                "proxyHttpPort": 7778,
                "renewGood": false,
                "proxyCountry": "US",
                "expireTime": 1751199998,
                "createTime": 1749903999000,
                "account": "**********",
                "proxyId": 93847
            }
        ],
        "searchCount": true,
        "orders": []
    },
    "ts": 1749955326816
}

修改静态IP备注

接口地址

/owlproxy/api/openApi/vcProxy/updateProxyName

请求方式

GET

请求数据类型

application/json

请求Query参数

参数名	示例值	参数类型	参数描述
proxyName	1	String	备注
proxyId	1	Integer	静态ip的id

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳

请求示例

?proxyName=45.192.43.243&proxyId=93847

响应示例

{
    "msg": "success",
    "code": 200,
    "ts": 1749955342960
}

静态IP续费

接口地址

/owlproxy/api/openApi/vcProxyGood/createRenewProxyOrder

请求方式

POST

请求数据类型

application/json

请求Body参数

参数名	示例值	参数类型	参数描述
proxyGoodId	1	Integer	套餐ID
proxyShopId	1	Integer	服务商ID
proxyIps	45.192.43.243	String	续费IP
backurl	"http://localhost:8080/callback"	String	回调URL

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳

请求示例

{
    "proxyGoodId": 1, // 套餐ID
    "proxyShopId": 1, // 服务商ID
    "proxyIps": "45.192.43.243", // 续费IP
}

响应示例

{
    "msg": "success",
    "code": 200,
    "ts": 1749955352069
}

批量计算续费价格

接口地址

/owlproxy/api/openApi/vcProxy/batchCalculateRenewPrice

请求方式

POST

请求数据类型

application/json

请求Body参数

参数名	示例值	参数类型	参数描述
proxyIps	["192.168.1.1","192.168.1.2"]	List<String>	续费的代理IP列表
renewalDays	30	Integer	续费天数（天）

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data		Object	响应数据
├─ totalPrice	280	Long	总价格（美分）
├─ ipCount	2	Integer	续费IP数量
├─ renewalDays	30	Integer	续费天数
├─ ipPriceDetails		List	价格详情列表
│ ├─ proxyIp	192.168.1.1	String	代理IP
│ ├─ unitPrice	140	Long	最终价格（美分）
│ ├─ originalPrice	175	Long	原价（美分）
│ ├─ subtotal	140	Long	小计（美分）
│ ├─ goodName	美国-住宅-IP	String	商品名称
│ ├─ shopId	1	Integer
│ ├─ goodPeriodDays	30	Integer	商品时段天数（天）
├─ errorList		List	错误信息列表
│ ├─ proxyIp	192.168.1.2	String	代理IP
│ ├─ errorMsg	IP has expired, cannot renew	String	错误信息

响应示例

{
    "msg": "success",
    "code": 200,
    "data": {
        "totalPrice": 280,
        "ipCount": 2,
        "renewalDays": 30,
        "ipPriceDetails": [
            {
                "proxyIp": "192.168.1.1",
                "unitPrice": 140,
                "originalPrice": 175,
                "goodPeriodDays": 30,
                "subtotal": 140,
                "goodName": "美国-住宅-IP",
                "shopId": 1
            }
        ],
        "errorList": [
            {
                "proxyIp": "192.168.1.2",
                "errorMsg": "IP has expired, cannot renew"
            }
        ]
    },
    "ts": 1751179652664
}

设置静态IP自动续费

接口地址

/owlproxy/api/openApi/vcProxy/autoRenewClose

请求方式

POST

请求数据类型

application/json

请求Body参数

参数名	示例值	参数类型	参数描述
proxyId	93847	Integer	代理ID
autoRenew	false	boolean	是: true 否: false

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳

请求示例

{
    "proxyId": 93847, // 代理ID
    "autoRenew": false // 是: true 否: false
}

响应示例

{
    "msg": "success",
    "code": 200,
    "ts": 1749955352069
}

静态IP订单列表

接口地址

/owlproxy/api/openApi/vcProxyOrder/selectProxyOrderList

请求方式

POST

请求数据类型

application/json

请求Body参数

参数名	示例值	参数类型	参数描述
page	1	Integer	当前页
rows	10	Integer	分页大小
completeStartTime	2025-06-13 00:00:00	String	开始时间
completeEndTime	2025-06-14 23:59:59	String	结束时间

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data
├─ total	10	Integer	总记录数
├─ pages	10	Integer	总页数
├─ records		Object[]	记录列表
│ ├─ goodNum	1	Integer	购买数量
│ ├─ createTime	1749909120000	Integer	创建时间
│ ├─ orderId	Owl-PROXY174990911995959082	String	订单编号
│ ├─ completeTime	1749909121000	Integer	支付时间
│ ├─ orderStatus	1	Integer	订单状态:0等待付款1付款完成2付款失败3已退款4已失效5退款中6退款失败
│ ├─ orderPrice	176	Integer	订单价格
│ ├─ businessType	1	Integer	1购买代理;2-代理续费
│ ├─ goodPrice	176	Integer	套餐价格

请求示例

{
    "completeStartTime": "2025-06-13 00:00:00", //开始时间
    "completeEndTime": "2025-06-14 23:59:59", // 结束时间
    "page": 1,
    "rows": 20
}

响应示例

{
    "msg": "success",
    "code": 200,
    "data": {
        "current": 1,
        "total": 5,
        "pages": 1,
        "optimizeCountSql": true,
        "size": 20,
        "records": [
            {
                "buyNumber": 1,
                "goodName": "88折",
                "createTime": 1749909120000,
                "orderId": "Owl-PROXY174990911995959082",
                "payPrice": 176,
                "completeTime": 1749909121000,
                "orderStatus": 1,
                "orderPrice": 176,
                "businessType": 2,
                "goodPrice": 176,
                "goodNum": 1
            }
        ],
        "searchCount": true,
        "orders": []
    },
    "ts": 1749955360398
}

动态代理服务

查询动态流量余额

接口地址

/owlproxy/api/openApi/vcDynamicGood/queryCurrentTrafficBalance

请求方式

GET

请求数据类型

application/json

请求Query参数 无

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data
├─ useTraffic	0	Integer	已使用(MB)
├─ remainingTraffic	0	Integer	剩余(MB)
├─ accumulatedTraffic	0	Integer	总数(MB)

响应示例

{
    "msg": "success",
    "code": 200,
    "data": {
        "useTraffic": 0,
        "remainingTraffic": 8000,
        "accumulatedTraffic": 8000
    },
    "ts": 1749955456833
}

获取动态IP套餐

接口地址

/owlproxy/api/openApi/vcDynamicGood/getDynamicGoodService

请求方式

GET

请求数据类型

application/json

请求Query参数 无

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data
├─ goodName	2GB	String	商品名称
├─ createTime	1740639794000	Integer	创建时间
├─ oldPrice	800	Integer	原价
├─ recommendContent	25 折	String	推荐内容
├─ reorder	1	Integer	排序
├─ goodId	1	Integer	商品 ID
├─ goodPrice	600	Integer	现价
├─ firstPurchase	600	Integer	首购价
├─ totalTraffic	2000	Integer	大小(MB)

响应示例

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "goodName": "2GB",
            "createTime": 1740639794000,
            "oldPrice": 800,
            "recommendContent": "25折",
            "reorder": 1,
            "goodId": 1,
            "goodPrice": 600,
            "firstPurchase": 600,
            "totalTraffic": 2000
        },
    ],
    "ts": 1749955652636
}

购买动态IP套餐

接口地址

/owlproxy/api/openApi/vcDynamicGood/buyDynamicProxy

请求方式

POST

请求数据类型

application/json

请求Body参数

参数名	示例值	参数类型	参数描述
goodId	1	Integer	套餐id
goodNum	1	Integer	数量
autoRenewOrder	0	Integer	自动续费是: 1 否: 0

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳

请求示例

{
    "goodId": 1, // 套餐ID
    "goodNum": 1, // 数量
    "autoRenewOrder": 0 // 自动续费  是: 1 否: 0
}

响应示例

{
    "msg": "success",
    "code": 200,
    "ts": 1749956181581
}

获取动态IP提取地区

接口地址

/owlproxy/api/openApi/vcDynamicGood/getDynamicProxyRegion

请求方式

GET

请求数据类型

application/json

请求Query参数 无

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data
├─ city	Sharjahcity	String	城市
├─ state	Sharjah	String	州/省
├─ countryName	阿联酋	String	国家/地区
├─ region	AE	String	国家/地区

响应示例

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "city": "Sharjahcity",
            "state": "Sharjah",
            "countryName": "阿联酋",
            "region": "AE"
        }
    ],
    "ts": 1749956394204
}

获取动态IP提取线路

接口地址

/owlproxy/api/openApi/vcDynamicGood/getDynamicProxyHost

请求方式

GET

请求数据类型

application/json

请求Query参数 无

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data
├─ value	Sharjahcity	String	路线value
├─ name	Sharjah	String	路线name

响应示例

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "value": "change4.owlproxy.com:7778",
            "name": "美洲区（南美与北美）"
        },
        {
            "value": "change5.owlproxy.com:7778",
            "name": "亚太地区(包括大洋洲)"
        },
        {
            "value": "change6.owlproxy.com:7778",
            "name": "欧洲及非洲"
        }
    ],
    "ts": 1749956718585
}

动态IP提取

接口地址

/owlproxy/api/openApi/vcDynamicGood/createProxy

请求方式

POST

请求数据类型

application/json

请求Body参数

参数名	示例值	参数类型	参数描述
countryCode	AE	String	国家/地区
state	Sharjah	String	州/省
city	Sharjahcity	String	城市
proxyHost	change4.owlproxy.com:7778	String	线路
proxyType	socks5	String	协议 socks5 http https
time	5	Integer	IP轮换周期(分钟) 5/10/15/30/45/60/90
goodNum	1	Integer	数量

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data
├─ proxyHost	change4.owlproxy.com	String	host
├─ proxyPort	7778	String	端口
├─ userName	******_custom_zone_AE_st__city_sid_34494893_time_5	String	账号
├─ password	******	String	密码
├─ proxyType	socks5	String	协议

请求示例

{
    "countryCode": "AE", // 国家/地区
    "state": "Sharjah", // 州/省
    "city": "Sharjahcity", // 城市
    "proxyHost": "change4.owlproxy.com:7778", // 线路
    "proxyType": "socks5", // 协议 socks5 http https
    "time": 5, // IP轮换周期(分钟)  5/10/15/30/45/60/90
    "goodNum": 1 // 数量
}

响应示例

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "proxyHost": "change4.owlproxy.com",
            "proxyPort": 7778,
            "userName": "J2uwNUFxjj90_custom_zone_AE_st__city_sid_34494893_time_5",
            "password": "997875",
            "proxyType": "socks5"
        }
    ],
    "ts": 1749957227938
}

动态IP自动续费订单

接口地址

/owlproxy/api/openApi/vcDynamicGood/getDynamicProxyAutomaticRenewal

请求方式

GET

请求数据类型

application/json

请求Query参数 无

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data
├─ good_size	2000	Integer	大小(MB)
├─ auto_renew_order	1	Integer	自动续费是: 1 否: 0
├─ order_price	600	Integer	价格(分)
├─ good_number	1	Integer	数量

响应示例

{
    "msg": "success",
    "code": 200,
    "data": [
        {
            "good_size": 2000,
            "auto_renew_order": 1,
            "order_price": 600.00,
            "good_name": "OwlProxy 动态流量",
            "good_number": 1
        }
    ],
    "ts": 1749957841875
}

动态IP设置自动续费

接口地址

/owlproxy/api/openApi/vcDynamicGood/setAutoRenewSwitch

请求方式

POST

请求数据类型

application/json

请求Body参数

参数名	示例值	参数类型	参数描述
autoRenewOrder	1	Integer	是: 1 否: 0

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳

请求示例

{
    "autoRenewOrder": 0 // 是: 1 否: 0
}

响应示例

{
    "msg": "success",
    "code": 200,
    "ts": 1749957839118
}

动态IP订单列表

接口地址

/owlproxy/api/openApi/vcDynamicGood/getDynamicProxyOrders

请求方式

POST

请求数据类型

application/json

请求Body参数

参数名	示例值	参数类型	参数描述
page	1	Integer	当前页
rows	10	Integer	分页大小
completeStartTime	2025-06-13 00:00:00	String	开始时间
completeEndTime	2025-06-14 23:59:59	String	结束时间

响应参数

参数名	示例值	参数类型	参数描述
msg	success	String	响应消息
code	200	Integer	状态码
ts	1736922808949	Integer	时间戳
data
├─ total	10	Integer	总记录数
├─ pages	10	Integer	总页数
├─ records		Object[]	记录列表
│ ├─ goodNum	1	Integer	购买数量
│ ├─ createTime	1749909120000	Integer	创建时间
│ ├─ orderId	Owl-PROXY174990911995959082	String	订单编号
│ ├─ completeTime	1749909121000	Integer	支付时间
│ ├─ orderStatus	1	Integer	订单状态:0等待付款1付款完成2付款失败3已退款4已失效5退款中6退款失败
│ ├─ orderPrice	600	Integer	订单价格
│ ├─ payPrice	600	Integer	支付价格
│ ├─ goodPrice	600	Integer	套餐价格
│ ├─ goodName	2GB	String	套餐名称
│ ├─ goodSize	2000	Integer	大小(MB)

请求示例

{
    "completeStartTime": "2025-06-13 00:00:00", // 开始时间
    "completeEndTime": "2025-06-14 23:59:59", // 结束时间
    "page": 1,
    "rows": 20
}

响应示例

{
    "msg": "success",
    "code": 200,
    "data": {
        "current": 1,
        "total": 5,
        "pages": 1,
        "optimizeCountSql": true,
        "size": 20,
        "records": [
            {
                "orderId": "Owl-PROXY174990416811621409",
                "orderPrice": 600.00,
                "payPrice": 600.00,
                "createTime": "2025-06-14 20:29:28",
                "completeTime": "2025-06-14 20:29:28",
                "orderStatus": 1,
                "goodId": 1,
                "goodNum": 1,
                "goodName": "2GB",
                "goodPrice": 600.00,
                "goodSize": 2000,
                "sumSize": 2000,
                "autoRenewOrder": 1
            },

        ],
        "searchCount": true,
        "orders": []
    },
    "ts": 1749955360398
}

回调管理

购买和续费静态IP套餐支付结果回调

使用场景

请先在购买静态IP套餐或者续费静态IP套餐接口中加入回调url

参数名	示例值	参数类型	参数描述
orderId	PROXY174841484014636643	String	订单号
amount	650	BigDecimal	变动金额（单位：美分）
completeTime	2025.01.01 01.01.01	String	完成时间 (格式: yyyy-MM-dd HH:mm:ss)
status	1	Integer	订单状态 1为购买成功，0为失败
proxyInfo		Object[]	代理信息列表，仅在包含代理资源时返回
├─ ip	185.145.12.11	String	代理 IP 地址
├─ port	3306	Integer	代理端口
├─ username	123	String	代理认证用户名
├─ password	123	String	代理认证密码
├─ httpPort	3306	Integer	代理http端口