IP云请求IP
本页目录
https://www.cloudam.cn/ip/queryip/{ORDER_ID}?protocol={PROTOCOL}®ionid={REGION_ID}&needpwd={NEEDPWD}&amount={amount}
请求方式：GET
IP云请求IP
URL Parameters
| Parameter | Type | Description |
|---|---|---|
| ORDER_ID | String | 订单ID，购买IP云套餐后会返回订单ID Example: K09f7AabcfrO3rcjFvlFHroabcglP8 |
| PROTOCOL | String | 协议类型，http和https请填proxy，socks5请填socks Example: proxy |
| REGION_ID | String | 地域id，美国为us Example: us |
| NEEDPWD | Boolean | 是否需要设置密码，true为需要，false为不需要 Example: true |
| AMOUNT | Integer | 请求的IP数量，单次不能大于套餐内的数量 Example: 50 |
Request(请求)
Headers(HTTP头)
注: 请首先联系Cloudam获取API Token，token相当于密码，请妥善保护。
{
"Authorization": "Bearer ${token}",
"Content-Type": "application/json"
}
Response(响应) - 200
Headers(响应头)
{
"Content-Type": "application/json"
}
Body(响应体JSON) -- 正确响应
{
"result": "success",
"data": [
{
"username": "wT0fCbvT4WInCW9",
"ip": "54.210.xxx.xxx",
"port": 20072,
"password": "pG26Rv75sLPyUtO",
"protocol": "socks"
} ],
"errorCode": null,
"ipAmount": 500
}
Response Body Attributes(响应Body属性)
| Attribute | Type | Description |
|---|---|---|
| result | String | 执行成功则返回success，失败则返回fail |
| errorCode | String | 错误代码，空字符串表示成功， User.NotAllowed 表示请求异常，User.NotEnoughBalance 表示账户余额不足, Cloud.NotEnoughResource 表示公有云资源不足，如：User.NotAllowed：用户传入不正确的参数。 |
| ipAmount | Integer | 单次返回的ip总个数 500 |
| data | Array | 返回的多个IP消息体 |
| username | String | ip设置的用户名，如果needpwd设置为false则为null |
| ip | String | ip |
| port | String | ip端口 |
| password | String | ip密码，如果needpwd设置为false则为null |
| protocol | String | 协议，分为proxy和socks |