| 节点列表 (查看状态) | ||
|---|---|---|
| 接口地址 | https://agentapi.ipip.net/nodes.json | |
| 请求方式 | HTTP GET | |
| 示例 | curl "https://agentapi.ipip.net/nodes.json" -H "Token: 123456" | |
| 响应 |
[
{
"node":1,
"name":"北京电信"
},
{
"node":3,
"name":"浙江杭州联通"
},
...
]
|
|
| Ping | ||
|---|---|---|
| 接口地址 | https://agentapi.ipip.net/ping.json | |
| 请求方式 | HTTP GET | |
| 参数 | host | www.baidu.com |
| count | 4 （默认4次，最大不能超过10） | |
| node | 1 （节点编号） | |
| format | 0 (只能是0或1) | |
| 示例 | curl "https://agentapi.ipip.net/ping.json?host=www.baidu.com&count=5&node=100" -H "Token: 123456" | |
| 响应 |
{
"ret":0,
"data":<元数据见右侧>
}
|
PING 8.8.8.8 (8.8.8.8) 56(84) bytes of data.
64 bytes from 8.8.8.8: icmp_seq=1 ttl=43 time=71.8 ms
64 bytes from 8.8.8.8: icmp_seq=3 ttl=43 time=69.7 ms
64 bytes from 8.8.8.8: icmp_seq=4 ttl=43 time=72.1 ms
64 bytes from 8.8.8.8: icmp_seq=5 ttl=43 time=71.0 ms
--- 8.8.8.8 ping statistics ---
5 packets transmitted, 4 received, 20% packet loss, time 5004ms
rtt min/avg/max/mdev = 69.751/71.195/72.192/0.956 ms
|
| Dig | ||
|---|---|---|
| 接口地址 | https://agentapi.ipip.net/dig.json | |
| 请求方式 | HTTP GET | |
| 参数 | host | g.alicdn.com |
| dns | 114.114.114.114 | |
| node | 1 （节点编号） | |
| format | 0 (只能是0或1) | |
| 示例 | curl "https://agentapi.ipip.net/dig.json?host=g.alicdn.com&dns=114.114.114.114&node=100" -H "Token: 123456" | |
| 响应 |
{
"ret":0,
"data":<元数据见右侧>
}
|
; <<>> DiG 9.8.2rc1-RedHat-9.8.2-0.30.rc1.el6_6.3 <<>> g.alicdn.com @114.114.114.114
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 54481
;; flags: qr rd ra; QUERY: 1, ANSWER: 3, AUTHORITY: 0, ADDITIONAL: 0
;; QUESTION SECTION:
;g.alicdn.com. IN A
;; ANSWER SECTION:
g.alicdn.com. 22814 IN CNAME g.alicdn.com.danuoyi.alicdn.com.
g.alicdn.com.danuoyi.alicdn.com. 30 IN A 222.186.49.240
g.alicdn.com.danuoyi.alicdn.com. 30 IN A 222.186.49.250
;; Query time: 27 msec
;; SERVER: 114.114.114.114#53(114.114.114.114)
;; WHEN: Fri Jun 26 14:44:05 2015
;; MSG SIZE rcvd: 97
|
| TraceRoute | ||
|---|---|---|
| 接口地址 | https://agentapi.ipip.net/tracert.json | |
| 请求方式 | HTTP GET | |
| 参数 | host | 8.8.8.8 |
| t | I （I: ICMP协议 / T: TCP协议） | |
| hops | 30 （默认30，最大不能超过30） | |
| node | 1 （节点编号） | |
| format | 0 (只能是0或1) | |
| 示例 | curl "https://agentapi.ipip.net/tracert.json?host=8.8.8.8&hops=30&node=100" -H "Token: 123456" | |
| 响应 |
{
"ret":0,
"data":<元数据见右侧>
}
|
1 118.26.235.97 (118.26.235.97) 3.871 ms 4.286 ms 4.757 ms
2 42.62.127.61 (42.62.127.61) 2.538 ms 2.741 ms 2.889 ms
3 42.62.127.69 (42.62.127.69) 1.627 ms 1.797 ms 1.969 ms
4 42.62.63.186 (42.62.63.186) 1.644 ms 1.861 ms 2.044 ms
5 * * *
6 61.148.7.217 (61.148.7.217) 4.866 ms 3.087 ms 3.058 ms
7 124.65.57.121 (124.65.57.121) 2.944 ms 2.895 ms 2.793 ms
8 123.126.0.9 (123.126.0.9) 4.664 ms 4.192 ms 3.990 ms
9 219.158.19.34 (219.158.19.34) 37.151 ms 37.629 ms 37.621 ms
10 219.158.3.250 (219.158.3.250) 48.655 ms 48.658 ms 48.655 ms
11 219.158.96.254 (219.158.96.254) 110.272 ms 110.280 ms 110.281 ms
12 219.158.97.246 (219.158.97.246) 124.475 ms 124.489 ms 124.520 ms
13 * * *
14 * * *
15 * 216.239.40.35 (216.239.40.35) 70.017 ms 70.020 ms
16 209.85.252.249 (209.85.252.249) 64.327 ms * 64.325 ms
17 72.14.237.171 (72.14.237.171) 76.165 ms 70.232 ms 69.784 ms
18 * * *
19 google-public-dns-a.google.com (8.8.8.8) 73.540 ms 73.530 ms *
|
| httpHead | ||
|---|---|---|
| 接口地址 | https://agentapi.ipip.net/httpHead.json | |
| 请求方式 | HTTP GET | |
| 参数 | url | 8.8.8.8 |
| node | 1 （节点编号） | |
| 示例 | curl "https://agentapi.ipip.net/httpHead.json?url=www.ipip.net&node=100" -H "Token: 123456" | |
| 响应 |
{
"ret":0,
"data":<元数据见右侧>
}
|
HTTP/1.1 200 OK
Date: Mon, 07 Sep 2015 06:18:36 GMT
Content-Type: text/html; charset=utf-8
Connection: keep-alive
Keep-Alive: timeout=20
Vary: Accept-Encoding
Cache-Control: no-cache
|
| 异步执行 | ||
|---|---|---|
| 接口地址 | https://agentapi.ipip.net/multi/add.json | |
| 请求方式 | HTTP GET | |
| 参数 | cmd | ping | dig | tracert | httpHead |
| ids | 3,10,21 （节点编号列表,使用逗号连接） | |
| tag | 北京,上海,广州 (标签用逗号连接，表示选择了北京上海广州三地的全部节点) | |
| api | http://domain.com/apipath 回调地址,使用post发送json数据请求此接口 | |
| 示例 |
curl "https://agentapi.ipip.net/multi/add.json?cmd=ping&tag=北京&host=www.qq.com&api=http://callback/url" -H "Token: 123456" curl "https://agentapi.ipip.net/multi/add.json?cmd=dig&host=s.qdcdn.com&dns=8.8.8.8&tag=华北,联通&ids=1,2,3,4,5,6" -H "Token: 123456" |
|
| 响应 |
{
ret: 0,
data: {
taskId: 5
}
}
|
|
| 异步执行结果获取接口 | ||
|---|---|---|
| 接口地址 | https://agentapi.ipip.net/multi/get.json | |
| 请求方式 | HTTP GET | |
| 参数 | taskId | 5 |
| 示例 | curl "https://agentapi.ipip.net/multi/get.json?taskId=5" -H "Token: 123456" | |
| 正常响应 |
{"ret":0,"data":[{"nodeId":100,"statusCode":200,"body":"..."}]}
|
|
| 状态码 |
{"ret":106,"data":"wait|execute|empty"}
wait:等待执行
execute:执行中
empty:数据不存在
|
|
| 注意 | 执行结果只保留2小时 | |
| speedDown | ||
|---|---|---|
| 接口地址 | https://agentapi.ipip.net/speedDown.json | |
| 请求方式 | HTTP GET | |
| 参数 | url | http://s.qdcdn.com/lovebizhi/AndroidWallpaper.apk |
| node | 1 （节点编号） | |
| 示例 | curl "https://agentapi.ipip.net/speedDown.json?url=http://s.qdcdn.com/lovebizhi/AndroidWallpaper.apk&node=100" -H "Token: 123456" | |
| 响应 |
{
ret: 0,
data: {
primary_ip: "x.x.x.x",
total_time: 0.552983,
namelookup_time: 0.150248,
connect_time: 0.154255,
pretransfer_time: 0.154303,
starttransfer_time: 0.206144,
speed_download: 370356,
download_content_length: 204801
}
}
|
|
| ret | 描述 |
|---|---|
| 0 | 正常 |
| 101 | 缺少 Token |
| 102 | token不存在或没有权限 |
| 103 | 缺少必要参数 |
| 104 | 缺少必要参数或者参数值不正确 |
| 105 | 后端服务异常 |
| 110 | 错误的响应 |