开发者API

请注意, 目前API只可以使用ProxyList里的新代理, 无法用来重复使用TodayList里的代理. 以下内容是如何使用API的方法和例子

首先登录软件后切换到AutoProxy页面, 勾选上"API Settings"里面的"Use API"

然后在911 S5软件目录下的"proxytool"文件夹内,你可以找到一个文件"Autoproxytool.exe"

你可以让你的程序带着如下命令行参数来运行该文件, 这样就可以实现全自动换代理. 注意使用API过程中, 911 S5要开着并保持登录状态:

Autoproxytool.exe -changeproxy/all 从任意国家, 随机用一个代理

Autoproxytool.exe -changeproxy/US 随机用一个US(美国)的代理

Autoproxytool.exe -changeproxy/US/NY 随机用一个US(美国), NY(纽约洲)的代理

Autoproxytool.exe -changeproxy/US/NY/New York City 随机用一个US(美国), NY(纽约洲), New York City(纽约市)的代理

你如果不知道想用的代理的国家缩写是什么, 你可以Google搜索: country ISO alpha-2 code

 

如果加上 -citynolimit 参数, 例如:

Autoproxytool.exe -changeproxy/US/NY/New York City/ -citynolimit

表示优先用 New York City(纽约市) 的代理, 如果没有这个城市的代理了, 再用 NY(纽约洲) 的, 简单说如果加上 -citynolimit 参数, 会优先尝试用指定城市的代理, 除非获取不到指定城市的代理(没有代理可用等情况)才会向下兼容用指定的洲的. 如果能够获取到指定城市的代理, API不会去尝试用指定洲的

 

Autoproxytool.exe -changeproxy/ -ip=123.123.123.123

该命令行可以获取指定IP的代理, 可以用*号替换进IP地址段内代表随机获取某IP段范围的代理, 例如: Autoproxytool.exe -changeproxy/ -ip=123.123.*.*Autoproxytool.exe -changeproxy/ -ip=123.*.*.*

 

Autoproxytool.exe -proxyport=

该命令行参数可以端口映射代理到指定的端口, 端口必须是在软件"Settings"里面设置的"port forward"端口范围内的端口, 重复使用该参数可以替换新的代理到该端口

Autoproxytool.exe -freeport=

该命令行参数可以释放掉在该端口已经端口映射了的代理

Autoproxytool.exe -proxyport=all

该命令行参数可以一次性批量映射软件"Settings"里面设置的"port forward"端口范围的所有端口到代理, 一个端口对应一个代理, 重复使用该参数可以替换新的一批代理到这些端口

Autoproxytool.exe -freeport=all

该命令行参数可以释放掉所有已经端口映射了的代理

Autoproxytool.exe -isp=

该命令行参数可以根据指定网络isp(网络服务提供商)来获取代理,支持*号进行模糊搜索,例如 Autoproxytool.exe -isp=S* 表示搜索以S开头的ISP, Autoproxytool.exe -isp=*Cable 表示搜索Cable结尾的ISP

Autoproxytool.exe -zip=

该命令行参数可以根据指定zip(邮编)来获取代理,支持*号进行模糊搜索,例如 Autoproxytool.exe -zip=800* 表示搜索800开头的邮编

 

这些参数可以用来结合本文中其他参数一起调用, 下面是一些API调用的例子:

Autoproxytool.exe -changeproxy/US/NY/New York City -proxyport=5000

Autoproxytool.exe -changeproxy/US/NY -proxyport=all

Autoproxytool.exe -changeproxy/US/NY -isp=Time Warner Cable

Autoproxytool.exe -changeproxy/US -zip=92626

Autoproxytool.exe -changeproxy/US/NY -isp=Time Warner Cable -proxyport=5000

Autoproxytool.exe -changeproxy/US -zip=92626 -proxyport=5000

 

-hwnd=

如果加上 -hwnd= 参数, Autoproxytool.exe 会给调用运行它的软件发送 WM_COPYDATA 消息

以便你的程序调用API后可以获得更多信息. -hwnd= 后面写上你调用运行 Autoproxytool.exe 的程序的窗体句柄

系统将会发送如下格式的 WM_COPYDATA 消息:

1. 如果API获取代理成功的情况下:

success|ip|Ping|代理国家|代理洲|代理城市|911S5账户余额

2. 如果API获取代理失败的情况下:

failed|失败原因

下面是一些API调用的例子:

Autoproxytool.exe -changeproxy/US/NY/New York City -hwnd=你程序的窗体句柄

Autoproxytool.exe -changeproxy/US/NY/New York City -citynolimit -hwnd=你程序的窗体句柄

Autoproxytool.exe -changeproxy/ -ip=123.123.*.* -hwnd=你程序的窗体句柄

Autoproxytool.exe -changeproxy/US/NY/New York City -proxyport=5000 -hwnd=你程序的窗体句柄

Autoproxytool.exe -changeproxy/US/NY -isp=Time Warner Cable -proxyport=5000 -hwnd=你程序的窗体句柄

Autoproxytool.exe -changeproxy/US -zip=92626 -proxyport=5000 -hwnd=你程序的窗体句柄

 

下面再解释一下同在软件AutoProxy页面里的"AutoProxy Settings"的功能和意义. 首先说明这个功能和上面提到的API提取代理是完全不相关的. 这个功能是通过软件面板上的设置, 来自动换代理并定时运行你设置的程序

要使用该功能, "API Settings"里面的"Use API"不勾选才能生效

除了设置好要用的目标代理的国家, 洲, 城市, zip, isp, 或ip段以外, 其他设置如下:

Auto run program when using new proxy(是否在换代理后自动运行你的程序, 是的话在select a program to auto run里选择)

Close the program before running(是否在换代理前, 关闭上一次运行的程序)

Delay [ ] --- [ ] Seconds before running the program (在自动换代理之前随机延迟的时间范围)

Save Settings 保存默认配置

Start AutoProxy 开始自动换代理

更新时间: 2019年9月12日

从911 S5 3.2版开始, 我们全新开发了一个API接口程序用于端口映射代理

新的API支持多线程同时调用, 可以同时发起多个请求来同时端口映射多个代理(上面提到的老API接口Autoproxytool.exe只支持单线程, 每一个请求都必须等待上一个请求操作完成)

如果你需要高频率的调用API来端口映射使用代理, 或需要同时发起多个API请求, 建议使用新的API. 关于新的API的使用方法如下:

在911 S5软件目录下的"proxytool"文件夹内, 你可以找到一个文件"ProxyAPI.exe"

你需要让你的程序带着命令行参数来运行该文件, 命令行参数格式和老API接口Autoproxytool.exe的一样, 但是需要包含参数 -proxyport= , 该参数后面的端口必须是在911 S5客户端Settings里所设置的端口映射范围内的, 注意使用API过程中, 911 S5要开着并保持登录状态, 以下是一些API的调用例子:

ProxyAPI.exe -changeproxy/US/NY/New York City -proxyport=5000, 端口映射一个New York City的代理到5000端口

ProxyAPI.exe -changeproxy/ -ip=123.123.*.* -proxyport=5000 -hwnd=你程序的窗体句柄, 端口映射一个123.123.*.*IP段内的代理到5000端口, 并发送反馈通知

ProxyAPI.exe -changeproxy/US/NY/New York City -citynolimit -proxyport=5000

ProxyAPI.exe -changeproxy/US/NY -isp=Time Warner Cable -proxyport=5000, 端口映射一个US, NY洲, isp为Time Warner Cable的代理到5000端口

ProxyAPI.exe -changeproxy/US -zip=92626 -proxyport=5000, 端口映射一个US, ZIP为92626的代理到5000端口

ProxyAPI.exe -changeproxy/US/NY -proxyport=all, 端口映射US, NY洲的代理到全部端口(911 S5客户端Settings里设置的端口映射范围内的全部端口)

ProxyAPI.exe -freeport=5000, 释放5000端口映射的代理

ProxyAPI.exe -freeport=all, 释放所有端口映射的代理