ipdouble工程openAPI文档

基础信息

● BASE_URL：https://ipdouble.com/slk-browser/openapi

● 认证请求头：secretKey:XXXXX

● 响应格式：统一使用ApiResponse封装，包含成功状态、数据及提示信息

1. 鉴权

需要在ipdouble获取用户秘钥

请求头参数

字段名	类型	描述	是否必填
secretKey	String	秘钥	是
Content-Type	String	application/json;charset=UTF-8	是

2. 地区查询接口

接口信息

● 接口地址：{{BASE_URL}}/listGoods

● 请求方式：GET

● 功能描述：查询可购买的代理商品地区及价格信息

请求参数（ListGoodsVO）

无

响应数据

● 类型：ApiResponse<List<ListGoodsVO>>

● 数据说明（ListGoodsVO）：

字段名	类型	描述
region	String	地区
address	String	详细地址
spu	String	商品编码
category	String	商品分类
deviceType	Integer	设备类型编码
deviceTypeStr	String	设备类型描述
priceList	List<ListGoodsPriceVO>	价格列表

● 价格列表说明（ListGoodsPriceVO）：

字段名	类型	描述
month	int	购买月份
amount	BigDecimal	价格金额
currency	String	货币类型（默认 USD）

3. 购买代理接口

接口信息

● 接口地址：{{BASE_URL}}/buyProxy

● 请求方式：POST

● 功能描述：购买代理服务，返回订单号

请求参数（BuyProxyDTO）

字段名	类型	描述	是否必填
spu	String	商品编码	是
month	int	购买月份	是
num	int	购买数量	是
requestId	String	请求唯一标识	是

响应数据

● 类型：ApiResponse<String>

● 数据说明：返回生成的订单号

4. 续费代理接口

接口信息

● 接口地址：{{BASE_URL}}/renewProxy

● 请求方式：POST

● 功能描述：对已购买的代理进行续费，返回订单号

请求参数（RenewProxyDTO）

字段名	类型	描述	是否必填
ip	String	代理 IP 地址	是
month	int	续费月份	是
requestId	String	请求唯一标识	是

响应数据

● 类型：ApiResponse<String>

● 数据说明：返回生成的续费订单号

5. 获取订单列表接口

接口信息

● 接口地址：{{BASE_URL}}/listOrder

● 请求方式：GET

● 功能描述：查询订单列表，支持分页查询

请求参数（QueryListOrderDTO）

字段名	类型	描述	是否必填
orderNumber	String	订单号	否
spu	String	商品编码	否
category	String	商品分类	否
deviceType	String	设备类型	否
region	String	地区	否
address	String	详细地址	否
pageNo	int	页码（默认 1）	否
pageSize	int	每页条数（默认 20）	否

响应数据

● 类型：ApiResponse<PageVO<ListOrderVO>>

● 分页信息（PageVO）：

字段名	类型	描述
pageNo	int	当前页码
pageSize	int	每页条数
total	long	总记录数
list	List<ListOrderVO>	订单列表数据

● 订单信息（ListOrderVO）：

字段名	类型	描述
orderNumber	String	订单号
payType	Integer	支付方式；3余额支付
payStatus	Integer	支付状态；1已支付 0 未支付
payTime	Date	支付时间
payAmount	BigDecimal	支付金额
payCurrency	String	支付货币类型
num	Integer	购买数量
month	int	购买月份
spu	String	商品编码
category	String	商品分类
deviceType	String	设备类型
region	String	地区
address	String	详细地址
ipList	List<String>	IP 列表

6. 代理列表接口

接口信息

● 接口地址：{{BASE_URL}}/listProxy

● 请求方式：GET

● 功能描述：查询已购买的代理列表

请求参数（ListGoodsVO）

字段名	类型	描述	是否必填
region	String	地区	否
address	String	详细地址	否
spu	String	商品编码	否
category	String	商品分类	否
deviceType	Integer	设备类型（枚举值）	否

响应数据

● 类型：ApiResponse<PageVO<ListProxyVO>>

● 分页信息（PageVO）：

字段名	类型	描述
pageNo	int	当前页码
pageSize	int	每页条数
total	long	总记录数
list	List<ListProxyVO>	订单列表数据

● 订单信息（ListProxyVO）：

字段名	数据类型	字段描述	示例值
ip	String	设备/服务的 IP 地址（如 IPv4 或 IPv6）	192.168.1.100
region	String	所属地域/区域（如城市、机房位置等）	北京/ 华东-上海
address	String	详细地址（物理地址或逻辑地址描述）	北京市海淀区中关村南大街5号
deviceType	String	设备类型编码（内部标识，如 01表示服务器，02表示网关等）	01
spu	String	SPU（标准化产品单元，通常用于商品/设备唯一标识，可选）	SPU_123456
expireTime	Date	过期时间（格式：yyyy-MM-dd HH:mm:ss，时区：东八区 UTC+8）	2025-12-31 23:59:59
createTime	Date	创建时间（格式：yyyy-MM-dd HH:mm:ss，时区：东八区 UTC+8）	2025-01-01 10:30:00
proxyAddress	String	代理服URL	proxy.example.com
proxyAccount	String	代理服务器登录账号	proxy_user
proxyPassword	String	代理服务器登录密码	proxy_pass123(示例)

附录：数据类型说明

1. ApiResponse：统一响应封装类

a. 成功：{ "code":200,"success": true, "data": ... }

b. 失败：{ "code":500,"success": false, "msg": "错误信息" }

2. 日期格式：统一使用yyyy-MM-dd HH:mm:ss格式,time-zone=Asia/Shanghai时区 UTC+8

3. 分页查询：所有分页接口默认页码从 1 开始，默认每页 20 条数据

4. deviceType: 1 机房 3 住宅 9 动态住宅 10 动态机房

开发者API