充值 余额: ¥0
官方客服: 微信:微信二维码微信二维码     定制微信:微信二维码微信二维码     ||| Telegram: @KooKeey_support | @Jacktan8866
API调用说明v2022.05.10
请求

API请求路径为: https://kookeey.com/

所有请求采用 HTTP GET 方式

请求固定包含accessidsignaturets3个参数

单账户的请求频率限制为 10 qps/s

https://kookeey.com/方法名?accessid=开发者ID&signature=参数字符串和时间戳的签名值&ts=请求发起时间戳(秒)
https://kookeey.com/stock?accessid=1&signature=ZDQyNmExY2FiOWZhNDdiMjAzNTYyYmFhZDZmMWIyNzM4N2FjM2JmMA==&g=433&ts=1609430400
签名

签名方式:将所有的请求参数拼接完成后,通过开发者token计算出拼接完字符串的的HMAC-SHA1值,最后进行base64编码

加密秘钥:请从账户中心获取

参数字符串:请查看每个接口的具体定义, 需要注意的是,加密的参数字符串的顺序需要与URL的参数顺序一致,例如,加密的参数字符串是:g=1&ts=1609430400;则URL是:/stock?accessid=1&signature=YzVkMjQxYjVmNjA2MWExMjAwYWYxMzUxM2I1YTY4YWYyOWIxMzA5NA==&g=1&ts=1609430400

说明:本文档所有请求示例,均使用加密秘钥1234567ABCDEFG进行加密

JAVA:Base64(HMAC-SHA1(加密秘钥,UTF-8-Encoding-Of(参数字符串)))

PHP(>=5.1.2):base64_encode(hash_hmac("sha1", 参数字符串, 加密秘钥, false))

PYTHON(>=3.0):base64.b64encode((hmac.new(bytes(加密秘钥,encoding='utf-8'),bytes(参数字符串.strip('&'),encoding='utf-8'),hashlib.sha1).hexdigest()).encode("utf-8"))

响应

响应数据使用JSON格式

标准返回包含四个参数:success/data/msg/code

响应参数类型描述
successbool接口响应状态,true表示成功,false表示失败
dataobject具体结果数据
msgstring结果说明
codeint结果码
结果码
0成功
10006参数错误
10015签名超时
20001数据状态错误
20002数据不存在
40001身份验证错误
40005余额不足
40008至少需要开启一种安全策略
40009无权执行该操作
40010账户密码认证已被关闭
40011存在设置单独的用户名密码的未过期线路
60001请求过于频繁
80003库存不足
80004订单无效
80005支付失败
80006端口正在配置中
80007订单正在支付中,请勿重复提交
80008静态端口不允许手动释放
订单
地区查询

接口:/stock?g=父级地区id

该接口返回已上架地区,以及目前每个地区库存

如果返回数组长度为0,则表示购买时会在该父级地区下随机分配地区

请求参数
参数名类型描述示例
gint地区父级id1:获取所有静态代理可用国家
433:获取美国所有静态代理地区
[当前支持的代理类型]
cint是否获取次级地区列表[可选参数]1:获取,返回结构会新增属性child
结果数据

类型:对象数组 (地区库存)

属性类型描述示例
idint地区id433
namestring地区英文名US
cnnamestring地区中文名美国
stockbool库存状态true :可用 / false:无库存
childarray次级地区以及库存状态 对象数组[附加参数] 只有请求时添加对应可选参数才会返回该字段同样包含 id,name,cnname,stock 4个属性
PHP示例: '/stock?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'g=1&ts=1609430400', '1234567ABCDEFG', false)).'&g=1&ts=1609430400'
示例结果: /stock?accessid=1&signature=YzVkMjQxYjVmNjA2MWExMjAwYWYxMzUxM2I1YTY4YWYyOWIxMzA5NA==&g=1&ts=1609430400
{"success":true,"data":[{"id":432,"name":"US","cnname":"美国","stock":true},{"id":11,"name":"CN","cnname":"中国","stock":true},{"id":501,"name":"SG","cnname":"新加坡","stock":false},{"id":444,"name":"DE","cnname":"德国","stock":false},{"id":504,"name":"PH","cnname":"菲律宾","stock":true}],"msg":"操作成功","code":0}
当前可用的代理类型ID

相关数据接口:[地区查询] [端口列表]

相关数据结构:[类型/地区对象 ]

ID描述
1静态数据中心
2动态家庭住宅
4静态ISP住宅
价格查询

接口:/price?g=地区id

该接口返回地区价格

请求参数
参数名类型描述示例
gint地区id433
结果数据

类型:对象 (地区价格)

属性类型描述示例
priceint价格,单位分1000
unitstring价格对应的套餐单位端口/30天
[套餐单位说明]
currencystring货币单位

套餐单位

代理类型描述示例
静态代理(数据中心/ISP住宅)端口/有效期端口/30天 : 按端口计费,端口有效期为30天
动态代理(住宅)GB(有效期)GB(30天) : 按流量每GB计费,端口有效期为30天
对于正式账户,有效期固定为30天;测试期可以联系管理员调整端口有效期
PHP示例: '/price?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'g=433&ts=1609430400', '1234567ABCDEFG', false)).'&g=433&ts=1609430400'
示例结果: /price?accessid=1&signature=ZDQyNmExY2FiOWZhNDdiMjAzNTYyYmFhZDZmMWIyNzM4N2FjM2JmMA==&g=433&ts=1609430400
{"success":true,"data":{"price":"1000","unit":"端口/30天","currency":"¥"},"msg":"操作成功","code":0}
新购

接口:/check?g=地区id&n=新购数量

该接口生成一张未支付新购订单,并返回订单费用信息

未支付订单的有效期为10分钟,10分钟后订单id会过期,不可进行支付确认

请求参数
参数名类型描述示例
gint地区id439
pstring协议socks5 / http
http=>http(s)协议
nint购买数量1
结果数据

类型:对象 (临时新购订单)

属性类型描述示例
orderidstring未支付订单id5283163557995843913770
priceint价格,单位分1000
unitstring价格对应的套餐单位端口/1天
[套餐单位说明]
currencystring货币单位
balanceint当前账户余额,单位分20000
uncountint账户余额中未扣除流量费,单位分0
costint支付订单需立即扣除金额,单位分1000
PHP示例: '/check?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'g=439&n=1&ts=1609430400', '1234567ABCDEFG', false)).'&g=439&n=1&ts=1609430400'
示例结果: /check?accessid=1&signature=MDJlZTBiMzQ3OGI1NDAzNGJlMzgyMjc0YzVkMWY1YWJhNGU5OWNhNQ==&g=439&n=1&ts=1609430400
{"success":true,"data":{"orderid":"5283163557995843913770","balance":548,"uncount":0,"price":20000,"unit":"GB(1天)","cost":20000,"currency":"¥"},"msg":"操作成功","code":0}
续订

接口:/checkr?p=端口id

接口生成一张未支付续订订单,并返回订单费用信息

未支付订单的有效期为10分钟,10分钟后订单id会过期,不可进行支付确认

只可以对未过期端口进行续订

请求参数
参数名类型描述示例
pint端口id2300790
结果数据

类型:对象 (临时续费订单)

属性类型描述示例
orderidstring未支付订单id5283163558121643316178
priceint价格,单位分1000
unitstring价格对应的套餐单位端口/1天
[套餐单位说明]
currencystring货币单位
balanceint当前账户余额,单位分20000
uncountint账户余额中未扣除流量费,单位分0
costint支付订单需立即扣除金额,单位分1000
daysint续订天数1
autorenewint该端口当前续订配置0:跟随用户全局续订策略
1:该端口强制自动续订
2:该端口强制关闭自动续订
PHP示例: '/checkr?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'p=2300790&ts=1609430400', '1234567ABCDEFG', false)).'&p=2300790&ts=1609430400'
示例结果: /checkr?accessid=1&signature=ZDI0ZjYxODI5MTIzMDViODY0ZTI0YWJhYzUxZDIwNGEyMjEwM2EzMw==&p=2300790&ts=1609430400
{"success":true,"data":{"orderid":"5283163558121643316178","balance":548,"uncount":0,"price":20000,"days":1,"unit":"GB(1天)","cost":20000,"currency":"¥","autorenew":0},"msg":"操作成功","code":0}
支付

接口:/pay?o=未支付订单id

该接口对未支付订单进行支付确认

未支付订单在支付确认后会生成一张真实订单,并根据订单信息自动分配/续订端口

端口分配为异步操作,一般支付完成后3分钟内会完成端口分配

如果端口分配失败,订单已支付金额会退回账户余额

请求参数
参数名类型描述示例
ostring未支付订单id5283163557995843913770
结果数据

类型:int

描述:真实订单id

示例:462084126

PHP示例: '/pay?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'o=5283163557995843913770&ts=1609430400', '1234567ABCDEFG', false)).'&o=5283163557995843913770&ts=1609430400'
示例结果: /pay?accessid=1&signature=NTM5MWNmMGU5YmUwNjQ0ZTM5MmEzMmUyOTgxMjY3MTc0NGJlZjg2ZQ==&o=5283163557995843913770&ts=1609430400
{"success":true,"data":462084126,"msg":"操作成功","code":0}
订单信息

接口:/oi?o=订单id

接口返回订单信息

请求参数
参数名类型描述示例
oint订单id462084126
结果数据

类型:对象 (订单信息)

属性类型描述示例
orderidint订单id462084126
ordertypestring订单类型新购 / 续订
daysint订单对应产品天数1
typeobject
[类型/地区对象 ]
订单所选类型对象{"id":2,"name":"RESIDENTIAL","cnname":"住宅端口"}
geoobject
[类型/地区对象 ]
订单所选国家对象{"id":433,"name":"US","cnname":"美国"}
regionobject
[类型/地区对象 ]
订单所选地区对象{"id":0,"name":"","cnname":""}
sharestring订单对应端口共享模式dedicated / share
protocolstring订单对应端口协议socks5
priceint单价,单位分1000
unitstring价格对应的套餐单位端口/1天
[套餐单位说明]
currencystring货币单位
numint订单购买数量2
realnumint订单实际成功购买数量1
portsarray [int]订单对应端口id数组[2300790]
statusstring订单状态未支付/订单处理中/订单完成/订单退款
timestring订单添加时间戳1609430400

类型/地区对象

属性类型描述示例
idint类型/国家/地区id433
0:表示上级地区随机
namestring英文名US
cnnamestring中文名美国
PHP示例: '/oi?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'o=462084126&ts=1609430400', '1234567ABCDEFG', false)).'&o=462084126&ts=1609430400'
示例结果: /oi?accessid=1&signature=N2ZlYjg3ZGNmMjFlZDYzZjhmNmI3YWZiYzZlNDUwNjIzMmQ0ZTg4NA==&o=462084126&ts=1609430400
{"success":true,"data":{"orderid":462084126,"type":{"id":2,"name":"RESIDENTIAL","cnname":"住宅端口"},"geo":{"id":433,"name":"US","cnname":"美国"},"region":{"id":0,"name":"","cnname":""},"ordertype":"新购","protocol":"socks5","share":"dedicated","num":1,"realnum":1,"price":20000,"unit":"GB(1天)","currency":"¥","days":1,"ports":[2300790],"status":"订单完成","time":1635581109},"msg":"操作成功","code":0}
订单列表

接口:/ol?s=查询开始时间戳&e=查询结束时间戳&ot=订单类型&p=页码

接口返回订单信息列表

请求参数
参数名类型描述示例
sint查询开始时间戳1633017600
eint查询结束时间戳1633622399
otint订单类型0:不限 / 1:新购 / 2:续费
ststring订单状态
pending:未完成(未支付/订单处理中)
confirm:订单完成
refund:订单退款(购买失败/手动退款)
不传参默认返回全部状态
piint订单关联线路ID8888888
pint查询页码1
结果数据

类型:对象 (列表信息)

属性类型描述示例
pageint当前页码1
page_sizeint单页数据条数10
totalint总数据量13
total_pageint总分页数2
listarray 对象数组
[订单信息对象]
结果数据[{订单信息对象},{订单信息对象}...]
PHP示例: '/ol?accessid=1&signature='.base64_encode(hash_hmac("sha1", 's=1633017600&e=1633622399&ot=0&p=1&ts=1609430400', '1234567ABCDEFG', false)).'&s=1633017600&e=1633622399&ot=0&p=1&ts=1609430400'
示例结果: /ol?accessid=1&signature=ZjhjOGQ4OTRkMDEyOWVkMDU4YzA0NTFhOGVjYmQyM2NjN2E2MWIyNQ==&s=1633017600&e=1633622399&ot=0&p=1&ts=1609430400
{"success":true,"data":{"page":2,"page_size":10,"total":13,"total_page":2,"list":[{"orderid":897918527,"ordertype":"续订","protocol":"socks5","share":"dedicated","num":1,"realnum":0,"price":20000,"unit":"GB(3天)","currency":"¥","type":{"id":2,"name":"RESIDENTIAL","cnname":"住宅端口"},"geo":{"id":451,"name":"IT","cnname":"意大利"},"region":{"id":0,"name":"","cnname":""},"status":"订单退款","time":1635168701},{"orderid":864401537,"ordertype":"新购","protocol":"socks5","share":"dedicated","num":1,"realnum":1,"price":20000,"unit":"GB(3天)","currency":"¥","type":{"id":2,"name":"RESIDENTIAL","cnname":"住宅端口"},"geo":{"id":451,"name":"IT","cnname":"意大利"},"region":{"id":0,"name":"","cnname":""},"status":"订单完成","time":1635155600}]},"msg":"操作成功","code":0}
端口
端口信息

接口:/pi?p=端口id

接口返回端口信息

请求参数
参数名类型描述示例
pint端口id462084126
cint是否附加端口出口IP信息[可选参数]1:是
不传参默认不返回当前出口IP
结果数据

类型:对象 (端口信息)

属性类型描述示例
portidint端口id2300790
protocolstring端口协议socks5
proxyipistringntip107.151.187.174
proxyportint端口64825
sharestring端口共享模式dedicated / share
rotate_modeintip切换模式1:粘性 / 2:30min / 3:10min / 4:5min
静态端口该值恒为 1
next_changeip_timeint动态端口允许手动切换IP的时间戳1609430400
静态端口该值恒为 -
typeobject
[类型/地区对象 ]
订单所选类型对象{"id":2,"name":"RESIDENTIAL","cnname":"住宅端口"}
geoobject
[类型/地区对象 ]
订单所选国家对象{"id":433,"name":"US","cnname":"美国"}
regionobject
[类型/地区对象 ]
订单所选地区对象{"id":0,"name":"","cnname":""}
statusstring端口状态正常/停用/已过期/余额不足/异常
autorenewint该端口当前续订配置0:跟随用户全局续订策略
1:该端口强制自动续订
2:该端口强制关闭自动续订
default_autorenewint该类型端口用户全局续订策略0:不自动续订
1:自动续订
add_timeint端口添加时间戳1609430400
expire_timeint端口过期时间戳1635667562
ipstring该端口当前出口IP
[附加参数] 只有请求时添加对应可选参数才会返回该字段
192.168.1.1
对于状态关闭或者过期的线路,该值恒为 -
defaultauthint该端口是否使用全局连接账密
[附加参数] 只有请求时添加对应可选参数才会返回该字段
0:否,端口使用独立账密
1:是
authstrstring该端口连接账密
[附加参数] 只有请求时添加对应可选参数才会返回该字段
连接用户名:连接密码(如:aaaaaaaa:bbbbbbbb)
对于状态关闭或者过期的线路,该值恒为 -
PHP示例: '/pi?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'p=462084126&ts=1609430400', '1234567ABCDEFG', false)).'&p=462084126&ts=1609430400'
示例结果: /pi?accessid=1&signature=NGRmMDMzYjljNDk0MWVjYTk4MWVhZjJkYTNhZWYyZmQ3YTAzM2IyZg==&p=462084126&ts=1609430400
{"success":true,"data":{"portid":462084126,"protocol":"socks5","proxyip":"107.151.187.174","proxyport":64825,"share":"dedicated","rotate_mode":1,"type":{"id":2,"name":"RESIDENTIAL","cnname":"住宅端口"},"geo":{"id":433,"name":"US","cnname":"美国"},"region":{"id":0,"name":"","cnname":""},"status":"正常","autorenew":0,"add_time":1635581163,"expire_time":1635667562,"default_renew":0},"msg":"操作成功","code":0}
端口列表

接口:/pl?t=端口类型&g=地区id&p=页码

接口返回端口信息列表

请求参数
参数名类型描述示例
tint端口类型2
gint地区id[可选参数]433
0 表示不限制
pint查询页码1
sint端口状态[可选参数]1:正常
2:手动停用
3:已过期
不传参默认全部状态
aint端口账密[可选参数]查询特定 用户名/密码 认证的线路,支持模糊搜索
oint关联订单id[可选参数]111111111,精确匹配
ipstring出口/线路 IP,支持模糊搜索[可选参数]1.2.3.4 / 1.2.3 ,支持模糊搜索
tint端口类型2
cint是否附加端口出口IP信息[可选参数]1:是
不传参默认不返回当前出口IP
saint是否附加每个端口账密认证信息[可选参数]1:是
不传参默认不返回每个端口账密认证信息
结果数据

类型:对象 (列表信息)

属性类型描述示例
pageint当前页码1
page_sizeint单页数据条数10
totalint总数据量2
total_pageint总分页数1
listarray 对象数组
[端口信息对象]
结果数据[{端口信息对象},{端口信息对象}...]
PHP示例: '/pl?accessid=1&signature='.base64_encode(hash_hmac("sha1", 't=2&g=0&p=1&ts=1609430400', '1234567ABCDEFG', false)).'&t=2&g=0&p=1&ts=1609430400'
示例结果: /pl?accessid=1&signature=NzQ0ZWY2ZDk2NjZhNjc2Njk5MzlmMzJmNGUwYzYyMDE2N2JmNjYzOA==&t=2&g=0&p=1&ts=1609430400
{"success":true,"data":{"page":1,"page_size":10,"total":2,"total_page":1,"list":[{"portid":2300790,"proxyip":"107.151.187.174","proxyport":64825,"protocol":"socks5","rotate_mode":1,"type":{"id":2,"name":"RESIDENTIAL","cnname":"住宅端口"},"geo":{"id":433,"name":"US","cnname":"美国"},"region":{"id":0,"name":"","cnname":""},"autorenew":0,"default_autorenew":0,"status":"正常","add_time":1635581163,"expire_time":1635667562,"shutdown_time":0},{"portid":5071261,"proxyip":"107.151.187.174","proxyport":5242,"protocol":"socks5","rotate_mode":1,"type":{"id":2,"name":"RESIDENTIAL","cnname":"住宅端口"},"geo":{"id":448,"name":"ES","cnname":"西班牙"},"region":{"id":0,"name":"","cnname":""},"autorenew":0,"default_autorenew":0,"status":"已过期","add_time":1635238742,"expire_time":1635497941,"shutdown_time":1635498001}]},"msg":"操作成功","code":0}
恢复/停用

接口:/toggle?p=端口id&s=切换到状态

该接口可以恢复/停用端口

停用操作只是临时限制端口连接,并不能延长端口的过期时间

修改后生效时间为3分钟

请求参数
参数名类型描述示例
pint端口id2300790
sint切换到状态1:开启
2:停用
结果数据

类型:string

描述:无

PHP示例: '/toggle?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'p=2300790&s=1&ts=1609430400', '1234567ABCDEFG', false)).'&p=2300790&s=1&ts=1609430400'
示例结果: /toggle?accessid=1&signature=NzczOWQ1Y2VmM2E1NWY5MDIyZWE1ZWYwMjBmZGIzMjk1Mjk1YzcyMQ==&p=2300790&s=1&ts=1609430400
{"success":true,"data":"","msg":"操作成功","code":0}
释放

接口:/release?p=端口id

该接口可以提取释放未过期的动态端口

按周期计费的端口,释放后会退回未消费的计费周期

端口释放后,无法找回

仅对动态端口可用

修改后生效时间为3分钟

请求参数
参数名类型描述示例
pint端口id2300790
结果数据

类型:string

描述:无

PHP示例: '/release?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'p=462084126&ts=1609430400', '1234567ABCDEFG', false)).'&p=462084126&ts=1609430400'
示例结果: /release?accessid=1&signature=NGRmMDMzYjljNDk0MWVjYTk4MWVhZjJkYTNhZWYyZmQ3YTAzM2IyZg==&p=462084126&ts=1609430400
{"success":true,"data":"","msg":"操作成功","code":0}
修改ip切换周期

接口:/rotate?p=端口id&m=目标ip切换周期

该接口可以修改端口的IP切换周期

仅对动态端口可用

请求参数
参数名类型描述示例
pint端口id2300790
mint目标ip切换周期1:粘性 / 2:30min / 3:10min / 4:5min
结果数据

类型:string

描述:无

PHP示例: '/rotate?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'p=2300790&m=1&ts=1609430400', '1234567ABCDEFG', false)).'&p=2300790&m=1&ts=1609430400'
示例结果: /rotate?accessid=1&signature=ZTZjYWI5ZDkzN2Q1OWE2N2VlN2I4MjNlYTQ0MDc0OTc0YjlkOTk5NA==&p=2300790&m=1&ts=1609430400
{"success":true,"data":"","msg":"操作成功","code":0}
修改自动续费

接口:/prenew?p=端口id&s=目标续费模式

该接口可以修改端口自动续费模式

如果端口存在自动续费配置,则会覆盖用户全局续订策略

请求参数
参数名类型描述示例
pint端口id2300790
sint目标续费模式1:该端口强制自动续订
2:该端口强制关闭自动续订
结果数据

类型:string

描述:无

PHP示例: '/prenew?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'p=2300790&s=1&ts=1609430400', '1234567ABCDEFG', false)).'&p=2300790&s=1&ts=1609430400'
示例结果: /prenew?accessid=1&signature=NzczOWQ1Y2VmM2E1NWY5MDIyZWE1ZWYwMjBmZGIzMjk1Mjk1YzcyMQ==&p=2300790&s=1&ts=1609430400
{"success":true,"data":"","msg":"操作成功","code":0}
设置独立账密

接口:/changeauth?p=端口id&n=独立用户名&pwd=独立密码&del=删除独立账密

该接口可以设置某个端口的独立账密

如果端口存在独立账密配置,则会覆盖用户全局安全策略的账密设置

该设置只针对账密策略,添加了独立账密的线路,全局安全策略中的IP白名单依旧生效

如果账户中存在独立账密的端口,不允许关闭全局安全策略中的“账户密码认证”;同理,如果全局“账户密码认证”被关闭,则无法设置独立账密

修改后生效时间为3分钟

请求参数
参数名类型描述示例
pint端口id2300790
nstring验证用户名[可选参数]kookeey (6-16位数字或字母)
pwdstring验证密码[可选参数]12345678 (8-24位数字或字母)
delint删除独立账密[可选参数]1:删除该端口的独立账密,使用全局账密
del参数和n+pwd参数组合必须2选1
结果数据

类型:string

描述:无

PHP示例: '/changeauth?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'p=2300790&n=kookeey&pwd=12345678&ts=1609430400', '1234567ABCDEFG', false)).'&p=2300790&n=kookeey&pwd=12345678&ts=1609430400'
示例结果: /changeauth?accessid=1&signature=ZGU2OTUzM2VmOTE3Y2QyZmM2NGU2Y2QxNWVkY2ZlYjU5NDMxNjZlNg==&p=2300790&n=kookeey&pwd=12345678&ts=1609430400
{"success":true,"data":"","msg":"操作成功","code":0}
用量查询

接口:/pusage?p=端口id&d=查询日期

接口返回端口在查询日期内的每小时流量统计

统计数据延迟2小时

统计数据缓存时长为15分钟

请求参数
参数名类型描述示例
pint端口id2300790
dstring查询日期2021-10-01(系统采用东八时区)
结果数据

类型:对象 (小时统计)

属性类型描述示例
hourint小时1
countint流量统计,单位kb2365
feeint流量费用,单位分45
PHP示例: '/pusage?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'p=2300790&d=2021-10-01&ts=1609430400', '1234567ABCDEFG', false)).'&p=2300790&d=2021-10-01&ts=1609430400'
示例结果: /pusage?accessid=1&signature=ZTdmNWIxMzQ3NzBlMTk5NGIxZDE3NTVmZTI3OTI4NzY5MDViOTc5ZA==&p=2300790&d=2021-10-01&ts=1609430400
{"success":true,"data":[{"hour":0,"count":983,"fee":18},{"hour":1,"count":2365,"fee":45},{"hour":2,"count":3072,"fee":58},{"hour":3,"count":3061,"fee":58},{"hour":4,"count":40990,"fee":781},{"hour":5,"count":115650,"fee":2205},{"hour":6,"count":69478,"fee":1325},{"hour":7,"count":72161,"fee":1376},{"hour":8,"count":80046,"fee":1526},{"hour":9,"count":2283,"fee":43},{"hour":10,"count":128215,"fee":2445},{"hour":11,"count":119347,"fee":2276},{"hour":12,"count":82647,"fee":1576},{"hour":13,"count":95703,"fee":1825},{"hour":14,"count":80322,"fee":1532},{"hour":15,"count":74403,"fee":1419},{"hour":16,"count":66201,"fee":1262},{"hour":17,"count":105328,"fee":2008},{"hour":18,"count":54753,"fee":1044},{"hour":19,"count":0,"fee":0},{"hour":20,"count":0,"fee":0},{"hour":21,"count":0,"fee":0},{"hour":22,"count":0,"fee":0},{"hour":23,"count":0,"fee":0}],"msg":"操作成功","code":0}
切换IP

接口:/changeip?p=端口id

该接口可以申请主动切换某个端口的出口IP

单端口限制切换频率为1次/分钟

该功能默认对用户不开放,如需要使用,请向管理员申请

请求参数
参数名类型描述示例
pint端口id2300790
结果数据

PHP示例: '/changeip?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'p=2300790&ts=1609430400', '1234567ABCDEFG', false)).'&p=2300790&ts=1609430400'
示例结果: /changeip?accessid=1&signature=ZDI0ZjYxODI5MTIzMDViODY0ZTI0YWJhYzUxZDIwNGEyMjEwM2EzMw==&p=2300790&ts=1609430400
{"success":true,"data":"","msg":"操作成功","code":0}
获取IP

接口:/ip?p=端口id

该接口可以获取某个端口的当前出口IP

可配合切换功能,检查是否切换完成

请求参数
参数名类型描述示例
pint端口id2300790
结果数据

类型:string

描述:当前端口出口IP

示例:127.0.0.1

PHP示例: '/ip?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'p=2300790&ts=1609430400', '1234567ABCDEFG', false)).'&p=2300790&ts=1609430400'
/ip?accessid=1&signature=ZDI0ZjYxODI5MTIzMDViODY0ZTI0YWJhYzUxZDIwNGEyMjEwM2EzMw==&p=2300790&ts=1609430400
{"success":true,"data":"127.0.0.1","msg":"操作成功","code":0}
安全策略
获取

接口:/security?u=开发者ID

该接口返回用户当前的安全策略配置

请求参数
参数名类型描述示例
uint开发者ID1
结果数据

类型:对象

属性类型描述示例
openauthint账密验证1:开启 / 2:关闭
openwhiteipintip白名单验证1:开启 / 2:关闭
PHP示例: '/security?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'u=1&ts=1609430400', '1234567ABCDEFG', false)).'&u=1&ts=1609430400'
示例结果: /security?accessid=1&signature=YWJjNDkyM2M2YTYyOGEyZTIwMzAyOWIyNzliYTkzNmI5Zjg2NTJkZg==&u=1&ts=1609430400
{"success":true,"data":{"openauth":1,"openwhiteip":1},"msg":"操作成功","code":0}
设置

接口:/mod?i=验证模式&t=修改为状态

该接口可以修改安全策略

修改后生效时间为3分钟

请求参数
参数名类型描述示例
istring验证模式openauth:账密验证 / openwhiteip:ip白名单验证
tint修改为状态1:开启 / 2:关闭
结果数据

类型:string

描述:无

PHP示例: '/mod?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'i=openauth&t=1&ts=1609430400', '1234567ABCDEFG', false)).'&i=openauth&t=1&ts=1609430400'
示例结果: /mod?accessid=1&signature=NGY4ZWQzNDMxMzQxMzU4YjRmNDUzZDU4NzE3YTdmOWRjOTgyOGQzYQ==&i=openauth&t=1&ts=1609430400
{"success":true,"data":"","msg":"操作成功","code":0}
修改账密

接口:/auth?n=验证用户名&p=验证密码

该接口可以修改端口验证账户密码

修改后生效时间为3分钟

请求参数
参数名类型描述示例
nstring验证用户名kookeey (6-16位数字或字母)
pstring验证密码12345678 (8-24位数字或字母)
结果数据

类型:string

描述:无

PHP示例: '/auth?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'n=kookeey&p=12345678&ts=1609430400', '1234567ABCDEFG', false)).'&n=kookeey&p=12345678&ts=1609430400'
示例结果: /auth?accessid=1&signature=YmJmMDhlMTg4Njc3YzA3ZTViNmE0MTNlNjRiZTI1MTVlZGYwNzcxZQ==&n=kookeey&p=12345678&ts=1609430400
{"success":true,"data":"","msg":"操作成功","code":0}
添加白名单

接口:/addwhite?ip=ipv4地址

该接口可以添加IP白名单

修改后生效时间为3分钟

请求参数
参数名类型描述示例
ipstringipv4地址192.168.1.1
结果数据

类型:string

描述:无

PHP示例: '/addwhite?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ip=192.168.1.1&ts=1609430400', '1234567ABCDEFG', false)).'&ip=192.168.1.1&ts=1609430400'
示例结果: /addwhite?accessid=1&signature=ZTBlYTk4NTljMzViYzIzODE4M2QzMDU4ZTNhZDMwMmQ2OWZkMzMyNw==&ip=192.168.1.1&ts=1609430400
{"success":true,"data":"","msg":"操作成功","code":0}
移除白名单

接口:/delwhite?ip=ipv4地址

该接口可以把某个IP从白名单中移除

修改后生效时间为3分钟

请求参数
参数名类型描述示例
ipstringipv4地址192.168.1.1
结果数据

类型:string

描述:无

PHP示例: '/delwhite?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ip=192.168.1.1&ts=1609430400', '1234567ABCDEFG', false)).'&ip=192.168.1.1&ts=1609430400'
示例结果: /delwhite?accessid=1&signature=ZTBlYTk4NTljMzViYzIzODE4M2QzMDU4ZTNhZDMwMmQ2OWZkMzMyNw==&ip=192.168.1.1&ts=1609430400
{"success":true,"data":"","msg":"操作成功","code":0}
账户
余额

接口:/info?u=开发者ID

该接口返回用户当前的余额信息

请求参数
参数名类型描述示例
uint开发者ID1
结果数据

类型:对象

属性类型描述示例
balanceint当前账户余额,单位分548
uncountint账户余额中未扣除流量费,单位分10
PHP示例: '/info?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'u=1&ts=1609430400', '1234567ABCDEFG', false)).'&u=1&ts=1609430400'
示例结果: /info?accessid=1&signature=YWJjNDkyM2M2YTYyOGEyZTIwMzAyOWIyNzliYTkzNmI5Zjg2NTJkZg==&u=1&ts=1609430400
{"success":true,"data":{"balance":548,"uncount":10},"msg":"操作成功","code":0}