Proxy bear

HTTP API

test

描述 测试HTTP服务器状态
请求地址 http://{%host}:{%port}/test
请求示例 http://127.0.0.1:28776/test
响应示例 Hello, I'm ready

getLevel

描述 获取客户端Host参数
请求地址 http://{%host}:{%port}/getLevel
请求示例 http://127.0.0.1:28776/GetLevel
响应示例 XXXXXXXXXXXXXXXXXXXXXXXX

getActiveProxy

描述 获取"活动代理地址队列"中代理地址,成功后删除队列中相应的代理地址
请求地址 http://{%host}:{%port}/getActiveProxy
请求示例 http://127.0.0.1:28776/getActiveProxy
响应示例 203.108.67.52:8080
请求示例 http://127.0.0.1:28776/getActiveProxy?count=10&json=true&simple=false
响应示例 {"count":10,"proxies":[{"country":"CN","ip":"122.72.18.60","port":"8659"},{"country":"US","ip":"184.185.166.27","port":"8875"},{"country":"CN","ip":"103.235.245.35","port":"8841"},{"country":"US","ip":"166.62.86.208","port":"8789"},{"country":"US","ip":"52.69.20.245","port":"8467"},{"country":"CN","ip":"113.214.13.1","port":"8846"},{"country":"CN","ip":"139.217.24.50","port":"8664"},{"country":"US","ip":"47.89.41.164","port":"8884"},{"country":"US","ip":"12.157.129.35","port":"8908"},{"country":"US","ip":"184.72.93.83","port":"80"}]}
参数 类型 是否必填 描述
count int 获取代理地址的数量,缺省值是1
json bool 是否使用json格式返回代理地址数据,缺省值是false
simple bool 是否使用简单格式返回代理地址数据,缺省值是false

getTestedProxy

描述 获取"测试成功代理地址队列"中代理地址,成功后删除队列中相应的代理地址
请求地址 http://{%host}:{%port}/getTestedProxy
请求示例 http://127.0.0.1:28776/gettestedproxy
响应示例 203.108.67.52:8080
请求示例 http://127.0.0.1:28776/gettestedproxy?count=10&json=true&simple=false
响应示例 {"count":10,"proxies":[{"country":"CN","ip":"122.72.18.60","port":"8659"},{"country":"US","ip":"184.185.166.27","port":"8875"},{"country":"CN","ip":"103.235.245.35","port":"8841"},{"country":"US","ip":"166.62.86.208","port":"8789"},{"country":"US","ip":"52.69.20.245","port":"8467"},{"country":"CN","ip":"113.214.13.1","port":"8846"},{"country":"CN","ip":"139.217.24.50","port":"8664"},{"country":"US","ip":"47.89.41.164","port":"8884"},{"country":"US","ip":"12.157.129.35","port":"8908"},{"country":"US","ip":"184.72.93.83","port":"80"}]}
参数 类型 是否必填 描述
count int 获取代理地址的数量,缺省值是1
json bool 是否使用json格式返回代理地址数据,缺省值是false
simple bool 是否使用简单格式返回代理地址数据,缺省值是false

copyActiveProxy

描述 获取"活动代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/copyActiveProxy
请求示例 http://127.0.0.1:28776/copyactiveproxy
响应示例 203.108.67.52:8080
请求示例 http://127.0.0.1:28776/copyactiveproxy?count=10&json=true
响应示例 {"count":10,"proxies":[{"country":"CN","ip":"122.72.18.60","port":"8659"},{"country":"US","ip":"184.185.166.27","port":"8875"},{"country":"CN","ip":"103.235.245.35","port":"8841"},{"country":"US","ip":"166.62.86.208","port":"8789"},{"country":"US","ip":"52.69.20.245","port":"8467"},{"country":"CN","ip":"113.214.13.1","port":"8846"},{"country":"CN","ip":"139.217.24.50","port":"8664"},{"country":"US","ip":"47.89.41.164","port":"8884"},{"country":"US","ip":"12.157.129.35","port":"8908"},{"country":"US","ip":"184.72.93.83","port":"80"}]}
参数 类型 是否必填 描述
count int 获取代理地址的数量,缺省值是1
json bool 是否使用json格式返回代理地址数据,缺省值是false
simple bool 是否使用简单格式返回代理地址数据,缺省值是false

CopyTestedProxy

描述 获取"测试成功代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/CopyTestedProxy
请求示例 http://127.0.0.1:28776/Copytestedproxy
响应示例 203.108.67.52:8080
请求示例 http://127.0.0.1:28776/Copytestedproxy?count=10&json=true
响应示例 {"count":10,"proxies":[{"country":"CN","ip":"122.72.18.60","port":"8659"},{"country":"US","ip":"184.185.166.27","port":"8875"},{"country":"CN","ip":"103.235.245.35","port":"8841"},{"country":"US","ip":"166.62.86.208","port":"8789"},{"country":"US","ip":"52.69.20.245","port":"8467"},{"country":"CN","ip":"113.214.13.1","port":"8846"},{"country":"CN","ip":"139.217.24.50","port":"8664"},{"country":"US","ip":"47.89.41.164","port":"8884"},{"country":"US","ip":"12.157.129.35","port":"8908"},{"country":"US","ip":"184.72.93.83","port":"80"}]}
参数 类型 是否必填 描述
count int 获取代理地址的数量,缺省值是1
json bool 是否使用json格式返回代理地址数据,缺省值是false
simple bool 是否使用简单格式返回代理地址数据,缺省值是false

copyCrawlProxy

描述 获取"抓取代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/copyCrawlProxy
请求示例 http://127.0.0.1:28776/copycrawlproxy
响应示例 203.108.67.52:8080
请求示例 http://127.0.0.1:28776/copycrawlproxy?count=10&json=true
响应示例 {"count":10,"proxies":[{"country":"CN","ip":"122.72.18.60","port":"8659"},{"country":"US","ip":"184.185.166.27","port":"8875"},{"country":"CN","ip":"103.235.245.35","port":"8841"},{"country":"US","ip":"166.62.86.208","port":"8789"},{"country":"US","ip":"52.69.20.245","port":"8467"},{"country":"CN","ip":"113.214.13.1","port":"8846"},{"country":"CN","ip":"139.217.24.50","port":"8664"},{"country":"US","ip":"47.89.41.164","port":"8884"},{"country":"US","ip":"12.157.129.35","port":"8908"},{"country":"US","ip":"184.72.93.83","port":"80"}]}
参数 类型 是否必填 描述
count int 获取代理地址的数量,缺省值是1
json bool 是否使用json格式返回代理地址数据,缺省值是false
simple bool 是否使用简单格式返回代理地址数据,缺省值是false

removeActiveProxy

描述 删除"活动代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/removeActiveProxy
请求示例 http://127.0.0.1:28776/removeactiveproxy
响应示例 success
请求示例 http://127.0.0.1:28776/removeactiveproxy?count=100
响应示例 success
参数 类型 是否必填 描述
count int 删除代理地址的数量,=0时表示删除所有代理地址,缺省值是0

removeTestedProxy

描述 删除"测试成功代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/removeTestedProxy
请求示例 http://127.0.0.1:28776/removetestedproxy
响应示例 success
请求示例 http://127.0.0.1:28776/removetestedproxy?count=100
响应示例 success
参数 类型 是否必填 描述
count int 删除代理地址的数量,=0时表示删除所有代理地址,缺省值是0

removeBlockProxy

描述 删除"黑名单代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/removeBlockProxy
请求示例 http://127.0.0.1:28776/removeblockproxy
响应示例 success
请求示例 http://127.0.0.1:28776/removeblockproxy?count=100
响应示例 success
参数 类型 是否必填 描述
count int 删除代理地址的数量,=0时表示删除所有代理地址,缺省值是0

removeCrawlProxy

描述 删除"抓取代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/removeCrawlProxy
请求示例 http://127.0.0.1:28776/removecrawlproxy
响应示例 success
请求示例 http://127.0.0.1:28776/removecrawlproxy?count=100
响应示例 success
参数 类型 是否必填 描述
count int 删除代理地址的数量,=0时表示删除所有代理地址,缺省值是0

countActive

描述 获取"活动代理地址队列"中代理地址数量
请求地址 http://{%host}:{%port}/countActive
请求示例 http://127.0.0.1:28776/countactive
响应示例 2376

countTested

描述 获取"测试成功代理地址队列"中代理地址数量
请求地址 http://{%host}:{%port}/countTested
请求示例 http://127.0.0.1:28776/counttested
响应示例 682

countBlock

描述 获取"黑名单代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/countBlock
请求示例 http://127.0.0.1:28776/countblock
响应示例 13

countCrawl

描述 获取"抓取代理地址队列"中代理地址数量
请求地址 http://{%host}:{%port}/countCrawl
请求示例 http://127.0.0.1:28776/countcrawl
响应示例 19232

returnActiveProxy

描述 增加一个代理地址至"活动代理地址队列"
请求地址 http://{%host}:{%port}/returnActiveProxy
请求示例 http://127.0.0.1:28776/returnactiveproxy?proxy=222544204603288
响应示例 success
请求示例 http://127.0.0.1:28776/returnactiveproxy?proxy=aaaaaaa
响应示例 error
参数 类型 是否必填 描述
proxy long 整型表示的代理地址

returnBlockProxy

描述 增加一个代理地址至"黑名单代理地址队列"
请求地址 http://{%host}:{%port}/returnBlockProxy
请求示例 http://127.0.0.1:28776/returnblockproxy?proxy=222544204603288
响应示例 success
请求示例 http://127.0.0.1:28776/returnblockproxy?proxy=aaaaaaaa
响应示例 error
参数 类型 是否必填 描述
proxy long 整型表示的代理地址

returnTestedProxy

描述 增加一个代理地址至"测试成功代理地址队列"
请求地址 http://{%host}:{%port}/returnTestedProxy
请求示例 http://127.0.0.1:28776/returntestedproxy?proxy=222544204603288
响应示例 success
请求示例 http://127.0.0.1:28776/returntestedproxy?proxy=aaaaaaaa
响应示例 error
参数 类型 是否必填 描述
count long 整型表示的代理地址

SOCKET API

SOCKET请求数据包

  请求包固定长度共88byte,其中:

请求标志:4byte

请求方法:2byte

请求数量:4byte

代理ip地址:8byte

代理端口:2byte

身份认证编码:32byte

保留空白:32byte

请求标志结尾:4byte

偏移(byte) c++类型 c#类型 java类型 描述
0~3 char cvar[4] = "mplz" char[] cvar = new char[] {'m','p','l','z'} char[] cvar = new char[] {'m','p','l','z'} 固定值"mplz"
4~5 uint short ushort 代理地址请求方法
6~9 ulong int uint 请求数量
10~17 ULONGLONG long ulong 代理地址IP
18~19 uint short ushort 代理地址端口
20~51 BYTE *bytes byte[] byte[] 身份认证编码
52~83 BYTE *bytes byte[] byte[] 保留
84~87 char cvar[4] = "mplz" char[] cvar = new char[] {'m','p','l','z'} char[] cvar = new char[] {'m','p','l','z'} 固定值"mplz"
方法声明 描述
SOCKET_API_TEST 0 测试服务器是否成功
SOCKET_API_GET_ACTIVE 1 获取"活动代理地址队列"中代理地址,成功后删除队列中相应的代理地址
SOCKET_API_GET_TESTED 2 获取"测试成功代理地址队列"中代理地址,成功后删除队列中相应的代理地址
SOCKET_API_COPY_ACTIVE 3 获取"活动代理地址队列"中代理地址
SOCKET_API_COPY_TESTED 4 获取"测试成功代理地址队列"中代理地址
SOCKET_API_COPY_CRAWL 5 获取"抓取代理地址队列"中代理地址
SOCKET_API_REMOVE_ACTIVE 6 删除"活动代理地址队列"中代理地址
SOCKET_API_REMOVE_TESTED 7 删除"测试成功代理地址队列"中代理地址
SOCKET_API_REMOVE_CRAWL 8 删除"抓取代理地址队列"中代理地址
SOCKET_API_REMOVE_BLOCK 9 删除"黑名单代理地址队列"中代理地址
SOCKET_API_COUNT_ACTIVE 10 获取"活动代理地址队列"中代理地址数量
SOCKET_API_COUNT_TESTED 11 获取"测试成功代理地址队列"中代理地址数量
SOCKET_API_COUNT_CRAWL 12 获取"抓取代理地址队列"中代理地址数量
SOCKET_API_COUNT_BLOCK 13 获取"黑名单代理地址队列"中代理地址
SOCKET_API_RETURN_ACTIVE 14 增加一个代理地址至"活动代理地址队列"
SOCKET_API_RETURN_TESTED 15 增加一个代理地址至"测试成功代理地址队列"
SOCKET_API_RETURN_BLOCK 16 增加一个代理地址至"黑名单代理地址队列"

SOCKET响应

长度 描述
2byte 响应起始标志,固定值0x7F7E
1byte 响应状态
1byte 响应数据类型
4byte 响应数据长度
0..n 响应数据

  响应状态:

定义 描述
SOCKS_RETURN_ERROR_FAILD 0 请求执行失败
SOCKS_RETURN_ERROR_SUCCESS 1 请求执行成功

  响应数据类型:

响应数据类型 描述
SOCKET_RETURN_ERROR_NULL 0 空数据
SOCKET_RETURN_ERROR_DATA 1 代理地址或代理地址数量
SOCKET_RETURN_ERROR_AUTHTOKEN 2 身份验证错误
SOCKET_RETURN_ERROR_NOMETHOD 3 无效的请求
SOCKET_RETURN_ERROR_INVALIDPARAM 4 无效的请求参数

REMOTE API

GetTest

定义 string GetTest()
请求示例 return GetTest();
返回示例 "Hello , I'm ready."
描述 测试remoting服务是否启动

GetActiveProxies

定义 string[] GetActiveProxies(int count)
请求示例 return GetActiveProxies(1);
返回示例 string[1] {"203.102.66.27:8088"}
描述 获取"活动代理地址队列"中代理地址,成功后删除队列中相应的代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

GetSimpleActiveProxies

定义 ulong[] GetSimpleActiveProxies(int count)
请求示例 return GetSimpleActiveProxies(1);
返回示例 222544204603288
描述 获取"活动代理地址队列"中代理地址(代理地址的整型表示),成功后删除队列中相应的代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

GetTestedProxies

定义 string[] GetTestedProxies(int count)
请求示例 return GetTestedProxies(1);
返回示例 string[1] {"203.102.66.27:8088"}
描述 获取"测试成功代理地址队列"中代理地址,成功后删除队列中相应的代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

GetSimpleTestedProxies

定义 ulong[] GetSimpleTestedProxies(int count)
请求示例 return GetSimpleTestedProxies(1);
返回示例 222544204603288
描述 获取"测试成功代理地址队列"中代理地址(代理地址的整型表示),成功后删除队列中相应的代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

CopyActiveProxies

定义 string[] CopyActiveProxies(int count)
请求示例 return CopyActiveProxies(1);
返回示例 string[1] {"203.102.66.27:8088"}
描述 获取"活动代理地址队列"中代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

CopySimpleActiveProxies

定义 ulong[] CopySimpleActiveProxies(int count)
请求示例 return CopySimpleActiveProxies(1);
返回示例 222544204603288
描述 获取"活动代理地址队列"中代理地址(代理地址的整型表示)

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

CopyTestedProxies

定义 string[] CopyTestedProxies(int count)
请求示例 return CopyTestedProxies(1);
返回示例 string[1] {"203.102.66.27:8088"}
描述 获取"测试成功代理地址队列"中代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

CopySimpleTestedProxies

定义 ulong[] CopySimpleTestedProxies(int count)
请求示例 return CopySimpleTestedProxies(1);
返回示例 222544204603288
描述 获取"测试成功代理地址队列"中代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量(代理地址的整型表示),如果是0则获取所有代理地址

CopyCrawlProxies

定义 string[] CopyCrawlProxies(int count)
请求示例 return CopyCrawlProxies(1);
返回示例 string[1] {"203.102.66.27:8088"}
描述 获取"抓取代理地址队列"中代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

CopySimpleCrawlProxies

定义 ulong[] CopySimpleCrawlProxies(int count)
请求示例 return CopySimpleCrawlProxies(1);
返回示例 222544204603288
描述 获取"抓取代理地址队列"中代理地址(代理地址的整型表示)

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

RemoveActiveProxies

定义 void RemoveActiveProxies(int count)
请求示例 RemoveActiveProxies(1);
返回示例
描述 删除"活动代理地址队列"中代理地址

  参数

定义 范围 描述
int count 0..n 删除代理地址的数量,0表示删除所有代理地址

RemoveTestedProxies

定义 void RemoveTestedProxies(int count)
请求示例 RemoveTestedProxies(1);
返回示例
描述 删除"测试成功代理地址队列"中代理地址

  参数

定义 范围 描述
int count 0..n 删除代理地址的数量,0则删除所有代理地址

RemoveCrawlProxies

定义 void RemoveCrawlProxies(int count)
请求示例 RemoveCrawlProxies(1);
返回示例
描述 删除"抓取代理地址队列"中代理地址

  参数

定义 范围 描述
int count 0..n 删除代理地址的数量,0则删除所有代理地址

RemoveBlockProxies

定义 void RemoveBlockProxies(int count)
请求示例 RemoveBlockProxies(1);
返回示例
描述 删除"黑名单代理地址队列"中代理地址

  参数

定义 范围 描述
int count 0..n 删除代理地址的数量,0则删除所有代理地址

GetAcitveCount

定义 int GetAcitveCount()
请求示例 return GetAcitveCount();
返回示例 2376
描述 获取"活动代理地址队列"中代理地址数量

GetTestedCount

定义 int GetTestedCount()
请求示例 return GetTestedCount();
返回示例 823
描述 获取"测试成功代理地址队列"中代理地址数量

GetCrawlCount

定义 int GetCrawlCount()
请求示例 return GetCrawlCount();
返回示例
描述 获取"抓取代理地址队列"中代理地址数量

GetBlockCount

定义 int GetBlockCount()
请求示例 return GetBlockCount();
返回示例 27
描述 获取"黑名单代理地址队列"中代理地址数量

ReturnActive

定义 bool ReturnActive(string proxy)
请求示例 return ReturnActive("203.136.28.11:8088");
返回示例 true
描述 增加一个代理地址至"活动代理地址队列"

  参数

定义 范围 描述
string proxy 代理地址的字符串表示{%host:%port}

ReturnSimpleActive

定义 bool ReturnSimpleActive(ulong proxy)
请求示例 return ReturnSimpleActive(222544204603288);
返回示例 true
描述 增加一个代理地址至"活动代理地址队列"

  参数

定义 范围 描述
ulong proxy 代理地址的整型表示

ReturnTested

定义 bool ReturnTested(string proxy)
请求示例 return ReturnTested("203.136.28.11:8088");
返回示例 true
描述 增加一个代理地址至"测试成功代理地址队列"

  参数

定义 范围 描述
string proxy 代理地址的字符串表示{%host:%port}

ReturnSimpleTested

定义 bool ReturnSimpleTested(ulong proxy)
请求示例 return ReturnSimpleTested(222544204603288);
返回示例 true
描述 增加一个代理地址至"测试成功代理地址队列"

  参数

定义 范围 描述
ulong proxy 代理地址的整型表示

ReturnBlock

定义 bool ReturnBlock(string proxy)
请求示例 return ReturnBlock("203.136.28.11:8088");
返回示例 true
描述 增加一个代理地址至"黑名单代理地址队列"

  参数

定义 范围 描述
string proxy 代理地址的字符串表示{%host:%port}

ReturnSimpleBlock

定义 bool ReturnSimpleBlock(ulong proxy)
请求示例 return ReturnSimpleBlock(222544204603288);
返回示例 true
描述 增加一个代理地址至"黑名单代理地址队列"

  参数

定义 范围 描述
ulong proxy 代理地址的整型表示

Proxy hound

HTTP API

test

描述 测试HTTP服务器状态
请求地址 http://{%host}:{%port}/test
请求示例 http://127.0.0.1:28801/test
响应示例 Hello, I'm ready

getLevel

描述 获取客户端Host参数
请求地址 http://{%host}:{%port}/getLevel
请求示例 http://127.0.0.1:28801/GetLevel
响应示例 XXXXXXXXXXXXXXXXXXXXXXXX

getHttp

描述 获取"http代理地址队列"中代理地址,成功后删除队列中相应的代理地址
请求地址 http://{%host}:{%port}/getHttp
请求示例 http://127.0.0.1:28801/gethttp
响应示例 203.108.67.52:8080
请求示例 http://127.0.0.1:28776/gethttp?count=10&json=true
响应示例 {"count":10,"proxies":[{"country":"CN","ip":"122.72.18.60","port":"8659"},{"country":"US","ip":"184.185.166.27","port":"8875"},{"country":"CN","ip":"103.235.245.35","port":"8841"},{"country":"US","ip":"166.62.86.208","port":"8789"},{"country":"US","ip":"52.69.20.245","port":"8467"},{"country":"CN","ip":"113.214.13.1","port":"8846"},{"country":"CN","ip":"139.217.24.50","port":"8664"},{"country":"US","ip":"47.89.41.164","port":"8884"},{"country":"US","ip":"12.157.129.35","port":"8908"},{"country":"US","ip":"184.72.93.83","port":"80"}]}
参数 类型 是否必填 描述
count int 获取代理地址的数量,缺省值是1
json bool 是否使用json格式返回代理地址数据,缺省值是false
simple bool 是否使用简单格式返回代理地址数据,缺省值是false

getHttps

描述 获取"https代理地址队列"中代理地址,成功后删除队列中相应的代理地址
请求地址 http://{%host}:{%port}/gethttps
请求示例 http://127.0.0.1:28801/gethttps
响应示例 203.108.67.52:8080
请求示例 http://127.0.0.1:28801/gethttps?count=10&json=true&simple=false
响应示例 {"count":10,"proxies":[{"country":"CN","ip":"122.72.18.60","port":"8659"},{"country":"US","ip":"184.185.166.27","port":"8875"},{"country":"CN","ip":"103.235.245.35","port":"8841"},{"country":"US","ip":"166.62.86.208","port":"8789"},{"country":"US","ip":"52.69.20.245","port":"8467"},{"country":"CN","ip":"113.214.13.1","port":"8846"},{"country":"CN","ip":"139.217.24.50","port":"8664"},{"country":"US","ip":"47.89.41.164","port":"8884"},{"country":"US","ip":"12.157.129.35","port":"8908"},{"country":"US","ip":"184.72.93.83","port":"80"}]}
参数 类型 是否必填 描述
count int 获取代理地址的数量,缺省值是1
json bool 是否使用json格式返回代理地址数据,缺省值是false
simple bool 是否使用简单格式返回代理地址数据,缺省值是false

getSocks4

描述 获取"socks4代理地址队列"中代理地址,成功后删除队列中相应的代理地址
请求地址 http://{%host}:{%port}/getSocks4
请求示例 http://127.0.0.1:28801/getSocks4
响应示例 203.108.67.52:8088
请求示例 http://127.0.0.1:28801/getSocks4?count=10&json=true&simple=false
响应示例 {"count":10,"proxies":[{"country":"CN","ip":"122.72.18.60","port":"8659"},{"country":"US","ip":"184.185.166.27","port":"8875"},{"country":"CN","ip":"103.235.245.35","port":"8841"},{"country":"US","ip":"166.62.86.208","port":"8789"},{"country":"US","ip":"52.69.20.245","port":"8467"},{"country":"CN","ip":"113.214.13.1","port":"8846"},{"country":"CN","ip":"139.217.24.50","port":"8664"},{"country":"US","ip":"47.89.41.164","port":"8884"},{"country":"US","ip":"12.157.129.35","port":"8908"},{"country":"US","ip":"184.72.93.83","port":"80"}]}
参数 类型 是否必填 描述
count int 获取代理地址的数量,缺省值是1
json bool 是否使用json格式返回代理地址数据,缺省值是false
simple bool 是否使用简单格式返回代理地址数据,缺省值是false

getSocks5

描述 获取"socks5代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/getSocks5
请求示例 http://127.0.0.1:28801/getSocks5
响应示例 203.108.67.52:8080
请求示例 http://127.0.0.1:28801/getSocks5?count=10&json=true
响应示例 {"count":10,"proxies":[{"country":"CN","ip":"122.72.18.60","port":"8659"},{"country":"US","ip":"184.185.166.27","port":"8875"},{"country":"CN","ip":"103.235.245.35","port":"8841"},{"country":"US","ip":"166.62.86.208","port":"8789"},{"country":"US","ip":"52.69.20.245","port":"8467"},{"country":"CN","ip":"113.214.13.1","port":"8846"},{"country":"CN","ip":"139.217.24.50","port":"8664"},{"country":"US","ip":"47.89.41.164","port":"8884"},{"country":"US","ip":"12.157.129.35","port":"8908"},{"country":"US","ip":"184.72.93.83","port":"80"}]}
参数 类型 是否必填 描述
count int 获取代理地址的数量,缺省值是1
json bool 是否使用json格式返回代理地址数据,缺省值是false
simple bool 是否使用简单格式返回代理地址数据,缺省值是false

delhttp

描述 删除"http代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/delhttp
请求示例 http://127.0.0.1:28801/delhttp
响应示例 success
请求示例 http://127.0.0.1:28801/delhttp?count=100
响应示例 success
参数 类型 是否必填 描述
count int 删除代理地址的数量,=0时表示删除所有代理地址,缺省值是0

delhttps

描述 删除"https代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/delhttps
请求示例 http://127.0.0.1:28801/delhttps
响应示例 success
请求示例 http://127.0.0.1:28801/delhttps?count=100
响应示例 success
参数 类型 是否必填 描述
count int 删除代理地址的数量,=0时表示删除所有代理地址,缺省值是0

delsocks4

描述 删除"socks4代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/delsocks4
请求示例 http://127.0.0.1:28801/delsocks4
响应示例 success
请求示例 http://127.0.0.1:28801/delsocks4?count=100
响应示例 success
参数 类型 是否必填 描述
count int 删除代理地址的数量,=0时表示删除所有代理地址,缺省值是0

delsocks5

描述 删除"socks5代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/delsocks5
请求示例 http://127.0.0.1:28801/delsocks5
响应示例 success
请求示例 http://127.0.0.1:28801/delsocks5?count=100
响应示例 success
参数 类型 是否必填 描述
count int 删除代理地址的数量,=0时表示删除所有代理地址,缺省值是0

countHttp

描述 获取"http代理地址队列"中代理地址数量
请求地址 http://{%host}:{%port}/countHttp
请求示例 http://127.0.0.1:28801/countHttp
响应示例 2376

countHttps

描述 获取"https代理地址队列"中代理地址数量
请求地址 http://{%host}:{%port}/countHttps
请求示例 http://127.0.0.1:28801/countHttps
响应示例 682

countSocks4

描述 获取"socks4代理地址队列"中代理地址
请求地址 http://{%host}:{%port}/countSocks4
请求示例 http://127.0.0.1:28801/countSocks4
响应示例 13

countSocks5

描述 获取"socks5代理地址队列"中代理地址数量
请求地址 http://{%host}:{%port}/countSocks5
请求示例 http://127.0.0.1:28801/countSocks5
响应示例 19232

SOCKET API

SOCKET请求数据包

  请求包固定长度共88byte,其中:

请求标志:4byte

请求方法:2byte

请求数量:4byte

代理ip地址:8byte

代理端口:2byte

身份认证编码:32byte

保留空白:32byte

请求标志结尾:4byte

偏移(byte) c++类型 c#类型 java类型 描述
0~3 char cvar[4] = "mplz" char[] cvar = new char[] {'m','p','l','z'} char[] cvar = new char[] {'m','p','l','z'} 固定值"mplz"
4~5 uint short ushort 代理地址请求方法
6~9 ulong int uint 请求数量
10~17 ULONGLONG long ulong 代理地址IP
18~19 uint short ushort 代理地址端口
20~51 BYTE *bytes byte[] byte[] 身份认证编码
52~83 BYTE *bytes byte[] byte[] 保留
84~87 char cvar[4] = "mplz" char[] cvar = new char[] {'m','p','l','z'} char[] cvar = new char[] {'m','p','l','z'} 固定值"mplz"
方法声明 描述
SOCKET_API_TEST 0 测试服务器是否成功
SOCKS_API_GET_HTTP 1 获取"http代理地址队列"中代理地址,成功后删除队列中相应的代理地址
SOCKS_API_GET_HTTPS 2 获取"https代理地址队列"中代理地址,成功后删除队列中相应的代理地址
SOCKS_API_GET_SOCKS4 3 获取"socks4代理地址队列"中代理地址
SOCKS_API_GET_SOCKS5 4 获取"socks5代理地址队列"中代理地址
SOCKS_API_REMOVE_HTTP 6 删除"http代理地址队列"中代理地址
SOCKS_API_REMOVE_HTTPS 15 删除"https代理地址队列"中代理地址
SOCKS_API_REMOVE_SOCKS4 8 删除"socks4代理地址队列"中代理地址
SOCKS_API_REMOVE_SOCKS5 9 删除"socks5代理地址队列"中代理地址
SOCKS_API_COUNT_HTTP 10 获取"http代理地址队列"中代理地址数量
SOCKS_API_COUNT_HTTPS 11 获取"https代理地址队列"中代理地址数量
SOCKS_API_COUNT_SOCKS4 5 获取"socks4代理地址队列"中代理地址数量
SOCKS_API_COUNT_SOCKS5 13 获取"socks5代理地址队列"中代理地址

SOCKET响应

长度 描述
2byte 响应起始标志,固定值0x7F7E
1byte 响应状态
1byte 响应数据类型
4byte 响应数据长度
0..n 响应数据

  响应状态:

定义 描述
SOCKS_RETURN_ERROR_FAILD 0 请求执行失败
SOCKS_RETURN_ERROR_SUCCESS 1 请求执行成功

  响应数据类型:

响应数据类型 描述
SOCKET_RETURN_ERROR_NULL 0 空数据
SOCKET_RETURN_ERROR_DATA 1 代理地址或代理地址数量
SOCKET_RETURN_ERROR_AUTHTOKEN 2 身份验证错误
SOCKET_RETURN_ERROR_NOMETHOD 3 无效的请求
SOCKET_RETURN_ERROR_INVALIDPARAM 4 无效的请求参数

REMOTE API

GetTest

定义 string GetTest()
请求示例 return GetTest();
返回示例 "Hello , I'm ready."
描述 测试remoting服务是否启动

GetHttp

定义 string[] GetHttp(int count)
请求示例 return GetHttp(1);
返回示例 string[1] {"203.102.66.27:8088"}
描述 获取"活http代理地址队列"中代理地址,成功后删除队列中相应的代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

GetSimpleHttp

定义 ulong[] GetSimpleHttp(int count)
请求示例 return GetSimpleHttp(1);
返回示例 222544204603288
描述 获取"http代理地址队列"中代理地址(代理地址的整型表示),成功后删除队列中相应的代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

GetHttps

定义 string[] GetHttps(int count)
请求示例 return GetHttps(1);
返回示例 string[1] {"203.102.66.27:8088"}
描述 获取"https代理地址队列"中代理地址,成功后删除队列中相应的代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

GetSimpleHttps

定义 ulong[] GetSimpleHttps(int count)
请求示例 return GetSimpleHttps(1);
返回示例 222544204603288
描述 获取"https代理地址队列"中代理地址(代理地址的整型表示),成功后删除队列中相应的代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

GetSocks4

定义 string[] GetSocks4(int count)
请求示例 return GetSocks4(1);
返回示例 string[1] {"203.102.66.27:8088"}
描述 获取"socks4代理地址队列"中代理地址,成功后删除队列中相应的代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

GetSimpleSocks4

定义 ulong[] GetSimpleSocks4(int count)
请求示例 return GetSimpleSocks4(1);
返回示例 222544204603288
描述 获取"socks4代理地址队列"中代理地址(代理地址的整型表示),成功后删除队列中相应的代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

GetSocks5

定义 string[] GetSocks5(int count)
请求示例 return GetSocks5(1);
返回示例 string[1] {"203.102.66.27:8088"}
描述 获取"socks5代理地址队列"中代理地址,成功后删除队列中相应的代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

GetSimpleSocks5

定义 ulong[] GetSimpleSocks5(int count)
请求示例 return GetSimpleSocks5(1);
返回示例 222544204603288
描述 获取"socks5代理地址队列"中代理地址(代理地址的整型表示),成功后删除队列中相应的代理地址

  参数

定义 范围 描述
int count 0..n 获取代理地址的数量,如果是0则获取所有代理地址

DelHttp

定义 void DelHttp(int count)
请求示例 DelHttp(1);
返回示例
描述 删除"http代理地址队列"中代理地址

  参数

定义 范围 描述
int count 0..n 删除代理地址的数量,0表示删除所有代理地址

DelHttps

定义 void DelHttps(int count)
请求示例 DelHttps(1);
返回示例
描述 删除"https代理地址队列"中代理地址

  参数

定义 范围 描述
int count 0..n 删除代理地址的数量,0则删除所有代理地址

DelSocks4

定义 void DelSocks4(int count)
请求示例 DelSocks4(1);
返回示例
描述 删除"socks4代理地址队列"中代理地址

  参数

定义 范围 描述
int count 0..n 删除代理地址的数量,0则删除所有代理地址

DelSocks5

定义 void DelSocks5(int count)
请求示例 DelSocks5(1);
返回示例
描述 删除"socks5代理地址队列"中代理地址

  参数

定义 范围 描述
int count 0..n 删除代理地址的数量,0则删除所有代理地址

CountHttp

定义 int CountHttp()
请求示例 return CountHttp();
返回示例 2376
描述 获取"http代理地址队列"中代理地址数量

CountHttps

定义 int CountHttps()
请求示例 return CountHttps();
返回示例 823
描述 获取"https代理地址队列"中代理地址数量

CountSocks4

定义 int CountSocks4()
请求示例 return CountSocks4();
返回示例
描述 获取"socks4代理地址队列"中代理地址数量

CountSocks5

定义 int CountSocks5()
请求示例 return CountSocks5();
返回示例 27
描述 获取"socks5代理地址队列"中代理地址数量