API 文档

1. 提取接口

网页提取: http://proxy.mimvp.com/fetch.php(普通用户使用)

API接口 : http://proxy.mimvp.com/api/fetch.php(有编程能力的开发者使用)

使用示例 : http://proxy.mimvp.com/demo2.php(包含Python,PHP,Java,C#,Shell)

2. 适用范围

a. 本文档适合具有一定编程能力的开发者参考使用;

b. 本文档的“请求参数字段”,对应于“提取代理”页面的筛选字段;

c. 本文档的“返回结果字段”,对应于“提取代理”页面的结果字段;

d. 本文档的字段和示例,同时适用于网页提取和API接口提取两种方式。

注意返回结果必选 IP + Port + http/https 等三个字段,因为代理必须配合协议使用(很多用户反馈代理无法使用原因在此)

3. 请求参数字段

请求参数 必填 参数含义 使用示例
orderid 订单号 / 用户邮箱 / 淘宝交易号(任选其一,订单详情页查看) 860150606141422818
xxx@mimvp.com
2015073000001000500059265231
num 提取数量,取值范围10 - 5000,不填写默认为100 100(默认
country 国家/省市(多选)

不填写
多个国家,用逗号(,)分隔
多个中国省市,用冒号(:)分隔
多个国家和多个中国省市,国家逗号分隔,省市冒号分隔


提取全部国家 (默认
美国,中国,日本
中国:北京:上海:广东
美国,中国:北京:上海:广东,日本
port 端口号(多选)

不填写
一个端口号
多个端口号,用逗号(,)分隔


提取全部端口号(默认
80
80,8123,3128
http_type 协议类型(多选)

0 - 全部
1 - HTTP
2 - HTTPS
3 - HTTP/HTTPS
4 - Socks4
5 - Socks5
6 - Socks4/Socks5


0        (提取全部协议,默认
1        (提取HTTP)
4        (提取Socks4)
1,2     (提取HTTP, HTTPS, HTTP/HTTPS)
4,5     (提取Socks4, Socks5, Socks4/Socks5)
1,4     (提取HTTP, Socks4)
1,2,4,5 (提取全部协议)
anonymous 匿名度(多选)

0 - 全部
2 - 透明
3 - 匿名
4 - 欺骗
5 - 高匿


0        (提取全部匿名度,默认
2        (提取透明)
3        (提取匿名+欺骗)
5        (提取高匿)
2,3     (提取透明,匿名+欺骗)
2,3,5  (提取透明,匿名+欺骗,高匿)
isp 运营商(多选)

0 - 全部
1 - 移动
2 - 铁通
3 - 联通
4 - 网通
5 - 电信
6 - 中华电信(台湾)
7 - 阿里巴巴 + 阿里云
8 - 腾讯集团 + 腾讯网络
10 - 鹏博士(宽带)
11 - PCCW + 电讯盈科
12 - 教育网
13 - BGP多线
14 - 方正宽带
15 - 长城宽带
16 - 广电网
17 - 百度
9 - 其他(运营商)


0        (提取全部运营商,默认
1        (提取移动)
7        (提取阿里巴巴+阿里云)
9        (提取不属于1-13的其他运营商)
1,3     (提取移动,联通)
1,3,5  (提取移动,联通,电信)
ping_time 响应时间(单选)

0    - 全部
0.3 - <0.3s
1    - <1s
5    - <5s


0        (提取全部响应时间,默认
0.3     (提取小于0.3秒)
1        (提取小于1秒)
5        (提取小于5秒)
transfer_time 传输速度(单选)

0   - 全部
1   - <1s
5   - <5s
10 - <10s


0        (提取全部传输速度,默认
1        (提取小于1秒)
5        (提取小于5秒)
10      (提取小于10秒)
result_fields 结果字段(多选)

1 - IP:Port  
2 - 协议类型      
3 - 匿名度
4 - 运营商
5 - 国家
6 - 响应时间
7 - 传输速度
9 - 验证时间


1,2         (提取IP:Port,类型,默认
1,2,3      (提取IP:Port,类型,匿名度)
1,2,9      (提取IP:Port,类型,验证时间)
1,2,5,9   (提取IP:Port,类型,国家,验证时间)
result_sort_field 结果排序(单选)

1 - 验证时间
2 - 响应时间
3 - 传输速度
4 - 检测成功率 (高级功能,IP稳定性)


1      (按验证时间排序,默认
2      (按响应时间排序)
3      (按传输速度时间排序)
4      (按检测成功率排序)
result_format 结果格式(单选)

txt   - TXT格式
xml  - XML格式
json - JSON格式


txt      (导出txt格式的结果,默认
xml     (导出xml格式的结果)
json    (导出json格式的结果)

4. 返回结果字段

结果参数 必返 参数含义 返回示例
code 返回状态

0       -   提取成功
1       -   没有邮箱地址
2       -   没有订单号
4       -   参数格式错误
8       -   不在有效期内
100    -   服务器升级中
101    -   系统异常,请稍候重试
-1      -   非法访问
0
code_msg 返回状态说明(请见“code”对应说明) 提取成功
result_count 结果数量 100
cost_time 请求耗时(单位秒) 0.167922
dtime 时间戳 2014-12-12 16:32:08
request 请求参数列表(包含用户邮箱,订单号等全部参数)
   user_email 用户邮箱 xxx@mimvp.com
   orderid 订单号 860150606141422818
   num 提取数量 100
   country 国家/省市 美国,中国:北京:上海,日本
   port 端口号 80,8080,8081
   http_type 协议类型 0
   anonymous 匿名度 0
   isp 运营商 0
   ping_time 响应时间 0
   transfer_time 传输速度 0
   result_fields 结果字段 1,2,9
   result_sort_field 结果排序 1
   result_format 结果格式 json
result 代理结果集合
   ip:port IP:Port 114.255.183.173:8080
   http_type 协议类型 HTTP
   anonymous 匿名度 高匿
   isp 运营商 联通
   country 国家/省市 中国:北京
   ping_time 响应时间(单位秒) 0.005495
   transfer_time 传输速度(单位秒) 0.118109
   check_dtime 验证时间 2014-12-12 16:30:08

5. 提取示例

字段名称 字段值示例 请求含义
orderid 860150606141422818 你购买付费后的订单号
num 100 提取100个代理
country 美国,中国:北京:上海,日本 提取指定国家/省市的代理
port 80,8080,8081 提取指定端口号的代理
http_type 0 默认值,即提取全部类型的代理
anonymous 0 默认值,即提取全部匿名度的代理
isp 0 默认值,即提取全部运营商的代理
ping_time 0 默认值,即提取全部响应时间的代理
transfer_time 0 默认值,即提取全部传输速度的代理
result_fields 1,2,3,4,5,6,7,9 返回结果,需要包含IP:Port,协议类型,匿名度,
运营商,国家/省市,响应时间,传输时间,验证时间等字段
result_sort_field 1 返回结果,按照验证时间排序
result_format json 返回结果为json格式

生成API接口链接:

5.1 返回JSON格式结果(result_format=json
5.2 返回XML格式结果(result_format=xml
5.3 返回TXT格式结果(result_format=txt