获取剩余可提取IP数量
最新更新时间：2021.09.15¶
本接口主要用于获取业务当前剩余可提取的IP总量。
业务说明
此接口只对动态代理业务有效：
- 动态代理包时业务，接口将返回当天可提取余量
- 动态代理包量业务，接口将返回订单总剩余提取余量
1. 接口说明¶
- 适用对象：所有付费用户
- 请求URL：http://v2.api.juliangip.com/dynamic/balance
- 请求方式：POST/GET
- 请求频率：10次/秒
2. 请求参数释义¶
| 参数名 | 变量 | 变量类型 | 是否必填 | 参数说明 |
|---|---|---|---|---|
| 业务编号 | trade_no | string | 是 | 由巨量系统生成的业务编号，全局唯一。 示例值：1765244755300652 |
| 加密签名 | sign | string | 是 | 根据规则加密后的sign字符串 示例值： 6f2bf01fa16e1c6bb1b70237dc3c7955 |
3. 调用示例¶
参数演示
- 业务编号：
1483587531995538 - key：
b433718d3e374fea8cd5a368ff8a3f4f
请求演示
GET http://v2.api.juliangip.com/dynamic/balance?
trade_no=1483587531995538&sign=6f2bf01fa16e1c6bb1b70237dc3c7955
Api加密规则详解
sign的计算方式请点击查看Api加密规则详解
4. 返回结果示例¶
请求成功返回示例¶
{
"code": 200,
"msg": "请求成功",
"data": {
"balance": 349
}
}
请求失败返回示例¶
{
"code": 401,
"msg": "签名验证失败,请检查签名参数和方法是否都符合签名算法要求",
"data": []
}
错误提示
大部分错误都可以在【公共错误及解决方案】找到解决办法，具体错误原因请参照msg字段中的错误原因释义，我们尽可能为您提供详细的错误原因提示。
5. 返回结果释义¶
| 参数名 | 变量 | 变量类型 | 是否必返 | 参数说明 |
|---|---|---|---|---|
| 返回码 | code | int | 是 | 返回结果状态码 示例值：200 |
| 结果描述 | msg | string | 是 | 针对于状态码的详细描述。 示例值：请求成功 |
| 数据内容 | data | object | 是 | 字典格式，key: 代理ip（格式ip:port），value: 剩余可用时长（int型） 示例：{"61.161.28.187:40919": 349, "182.34.26.141:37604": 691} |