API请求路径为: https://www.kookeey.com/
所有请求采用 HTTP GET 方式
请求固定包含accessid,signature和ts3个参数
单账户的请求频率限制为 10 qps/s
https://kookeey.com/方法名?accessid=开发者ID&signature=参数字符串和时间戳的签名值&ts=请求发起时间戳(秒)EXAMPLE:
https://kookeey.com/stock?accessid=1&signature=ZDQyNmExY2FiOWZhNDdiMjAzNTYyYmFhZDZmMWIyNzM4N2FjM2JmMA==&g=433&ts=1609430400签名方式:将所有的请求参数拼接完成后,通过开发者token计算出拼接完字符串的的HMAC-SHA1值,最后进行base64编码
accessid:开发者ID,请从账户信息获取
加密秘钥:请从账户中心获取
参数字符串:请查看每个接口的具体定义, 需要注意的是,加密的参数字符串的顺序需要与URL的参数顺序一致,例如,加密的参数字符串是:g=1&ts=1609430400;则URL是:/stock?accessid=1&signature=YzVkMjQxYjVmNjA2MWExMjAwYWYxMzUxM2I1YTY4YWYyOWIxMzA5NA==&g=1&ts=1609430400
说明:本文档所有请求示例,均使用加密秘钥1234567ABCDEFG进行加密,只是用作校验您的签名是否符合 API 的要求。 你向 API 发起请求时,请使用真实的数据
EXAMPLE:
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
响应参数 | 类型 | 描述 |
|---|---|---|
success | bool | 接口响应状态, |
data | object | 具体结果数据 |
msg | string | 结果说明 |
code | int | 结果码 |
0 | 成功 |
10003 | 系统错误 |
10005 | 系统繁忙,暂不展示流量数据和生成动态端口,IP提取模式和已生成线路不受影响,请耐心等候 |
10006 | 参数错误 |
10015 | 签名超时 |
10032 | 不支持的操作 |
10045 | 时间参数错误 |
10056 | 提交的备注信息过长 |
10059 | 签名错误或超时 |
10061 | 数量范围为1-99 |
10066 | 允许的操作数额为 1MB - 100TB |
10071 | 存在正在审核中的申请记录,请勿重复提交! |
20001 | 数据状态错误 |
20002 | 数据不存在 |
20003 | 数据已经存在 |
20004 | 用户名已经存在 |
30030 | 超过订单可以生成线路数量上限 |
30044 | 用户状态未激活,只能发送激活邮件 |
30051 | 所选地区UDP定制库存不足 |
30052 | http协议不支持UDP定制 |
30054 | 该IP存在风险,不允许添加 |
30055 | IP验证失败,请在正确的IP环境下打开验证链 |
30056 | 无可用白名单IP,需要先验证白名单IP |
30063 | 请输入6-16位数字字母(不分大小写)的账号 |
30064 | 请输入8-24位数字字母(不分大小写)的密码 |
40001 | 身份验证错误 |
40002 | 参数错误 |
40003 | 参数错误 |
40005 | 余额不足,请充值或更换支付方式 |
40008 | 至少需要开启一种安全策略 |
40009 | 无权执行该操作 |
40010 | 账户密码认证已被关闭 |
40011 | 存在设置单独的用户名密码的未过期线路 |
40012 | 动态流量余额不足,请购买动态代理流量包 |
40013 | 超过可开启独立线路上限 |
40014 | 产品尚未开放自主购买 |
40015 | 非活动用户,不可领取 |
40016 | 目标用户不在代理名下 |
40017 | 超过可批量处理数据上限 |
40019 | IP 白名单不能为空 |
40022 | 动态线路无续费操作 |
40031 | 当前账号有注销记录,请自注销当日算起至30日后重新注册 |
40033 | 已添加数据达到数量上限 |
40034 | 用户ID和开发者Token不匹配 |
40035 | 该用户已被其他账户绑为子账号 |
40036 | 已达不活跃独立端口上限,请先释放无效端口 |
40041 | 移动代理流量余额不足,请购买移动代理流量包 |
60001 | 请求过于频繁 |
60005 | 请正确设置数值 |
70001 | 静态数据中心不支持该业务,请选择其他类型产品 |
70003 | 当前数据存在未完成的操作,请等10分钟后操作 |
70004 | 无可用带宽包 |
70005 | 国家/地区信息不匹配 |
70006 | 无可用GRE隧道,或适配GRE隧道的资源不足 |
80003 | 库存不足 |
80004 | 订单无效 |
80005 | 支付失败 |
80006 | 端口正在配置中 |
80007 | 订单正在支付中,请勿重复提交 |
80008 | 静态端口不允许手动释放 |
80010 | 无效的优惠券 |
80011 | 订单金额未达到代金券优惠门槛 |
80012 | 优惠券不适用该订单 |
80013 | 该优惠券已被其他订单锁定 |
接口:/stockv2?g=父级地区id
该接口返回已上架地区,以及目前每个地区库存
如果返回数组长度为0,则表示购买时会在该父级地区下随机分配地区
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
g | int | 地区父级id | 1:获取所有静态数据中心代理可用国家 |
结果数据
类型:对象数组 (地区库存)
接口返回信息中stock只在查询静态数据中心/静态ISP时有效
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
cid | int | 大洲id | 1 |
cnname | string | 大洲中文名 | 美加和欧洲 |
id | int | 国家id | 432 |
name | string | 国家英文名 | US |
cnname | string | 国家中文名 | 美国 |
stock | bool | 库存状态 | true :可用 / false:无库存 |
child | array | 次级地区以及库存状态 对象数组 | 同样包含 id,name,cnname,stock 4个属性 |
EXAMPLE:
PHP示例: '/stockv2?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":[{"cid":1,"cnname":"美加和欧洲","child":[{"id":432,"name":"US","cnname":"美国","stock":true,"child":[{"id":530,"name":"California/Los Angeles","cnname":"加州(洛杉矶)","stock":true},{"id":2151,"name":"California/San Jose","cnname":"加州(圣何塞)","stock":true},{"id":2171,"name":"Dallas","cnname":"达拉斯","stock":false},{"id":2126,"name":"Illinois/Chicago","cnname":"伊利诺伊州(芝加哥)","stock":true},{"id":531,"name":"New York/New York City","cnname":"纽约州(纽约市)","stock":true},{"id":2133,"name":"Washington D.C.","cnname":"华盛顿特区","stock":true},{"id":2150,"name":"Washington/Seattle","cnname":"华盛顿州(西雅图)","stock":true}]}]}]}
接口:clientapi/citylist?g=父级地区id
该接口返回已上架城市
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
g | int | 地区父级id | 如果传代理类型,则返回该代理类型下所有城市 |
结果数据
类型:对象数组
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
id | int | 城市id | 101406 |
name | string | 名称编码 | Butler |
enname | string | 城市英文名 | Butler |
EXAMPLE:
PHP示例: '/citylist?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'g=626&ts=1609430400', '1234567ABCDEFG', false)).'&g=626&ts=1609430400'
示例结果: /citylist?accessid=1&signature=YzVkMjQxYjVmNjA2MWExMjAwYWYxMzUxM2I1YTY4YWYyOWIxMzA5NA==&g=626&ts=1609430400{"success":true,"data":[{"id":101406,"name":"Butler","enname":"Butler"},{"id":101407,"name":"Calhoun","enname":"Calhoun"},{"id":101408,"name":"Covington","enname":"Covington"},{"id":101409,"name":"Cullman","enname":"Cullman"},{"id":101410,"name":"Dallas","enname":"Dallas"},{"id":101411,"name":"Franklin","enname":"Franklin"},{"id":101284,"name":"Houston","enname":"Houston"},{"id":101285,"name":"Jackson","enname":"Jackson"},{"id":101412,"name":"Lawrence","enname":"Lawrence"},{"id":101413,"name":"Macon","enname":"Macon"},{"id":101291,"name":"Madison","enname":"Madison"},{"id":101414,"name":"Marion","enname":"Marion"},{"id":101415,"name":"Marshall","enname":"Marshall"},{"id":101292,"name":"Mobile","enname":"Mobile"},{"id":101416,"name":"Monroe","enname":"Monroe"},{"id":101417,"name":"Montgomery","enname":"Montgomery"},{"id":101418,"name":"Perry","enname":"Perry"},{"id":101419,"name":"Russell","enname":"Russell"},{"id":101420,"name":"Sumter","enname":"Sumter"},{"id":101421,"name":"Tuscaloosa","enname":"Tuscaloosa"},{"id":101422,"name":"Washington","enname":"Washington"}],"msg":"操作成功","code":0}
接口:/price?g=地区id
该接口返回地区价格
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
g | int | 地区id | 433 |
bw | int | 带宽值,加了该参数则显示拆分带宽价格 [可选参数] | 5 |
udp | int | 是否开启udp,加了该参数则显示拆分定制服务的价格 [可选参数] | 1 |
p | string | 下单的协议,加了该参数则显示拆分定制服务的价格 [可选参数] | vmess |
d | int | 购买月数,1-36,不传默认为1 [可选参数] | 1 |
sp | int | 加速城市id,如果有值,则返回的带宽价格折算了加速专线 [可选参数] | 0 |
参数p协议表
参数名 | 交付协议 |
|---|---|
http | Http |
socks5 | Socks5 |
vmess | Vmess |
ss | Shadowsocks |
wg | Wireguard |
结果数据
类型:对象 (地区价格)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
price | int | 价格,单位分 | 1000 |
unit | string | 价格对应的套餐单位 | 端口/30天 |
currency | string | 货币单位 | ¥ |
ip_price | number | 线路单价中,IP部分价格(单位:分) | 2500 |
service_price | number | 线路单价中,协议增值服务价格(单位:分) | 200 |
bw_price | number | 线路单价中,带宽部分价格(单位:分) | 4900 |
extra_bw_price | number | 额外添加1Mbps带宽的价格(单位:分) | 1400 |
套餐单位
代理类型 | 描述 | 示例 |
|---|---|---|
静态代理(数据中心/ISP住宅) | 端口/有效期 | 端口/30天 : 按线路计费,线路有效期为30天 |
动态代理(住宅) | GB(有效期) | GB(30天) : 按流量每GB计费,线路有效期为30天 |
对于正式账户,有效期固定为30天;测试期可以联系管理员调整线路有效期 | ||
EXAMPLE:
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&p=协议&n=新购数量
该接口生成一张未支付新购订单,并返回订单费用信息
未支付订单的有效期为10分钟,10分钟后订单id会过期,不可进行支付确认
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
g | int | 地区id | 439 |
p | string | 协议 | socks5 / http |
n | int | 购买数量 | 1 |
t | int | 业务类型 [可选参数] | 1 Amazon |
d | int | 购买的月数(30个自然日作为一个标准月长度) [可选参数] | 3,表示该 IP购买3个月(90天)使用期 |
udp | int | 是否开启udp,默认为0 [可选参数] | 0:udp关闭/1:udp开启 |
bw | int | 使用的带宽,如果使用带宽包,该值传-1,否则取值范围为5-200 [可选参数] | 6 |
soft | int | 选择使用环境 [可选参数] | 201 |
sp | int | 加速入口城市id [可选参数] | 0 |
参数t对应业务表
t | 业务 | t | 业务 |
|---|---|---|---|
1 | Amazon | 31 | Eve |
2 | Paypal | 32 | SoleAIO |
3 | 33 | Cybersole | |
4 | 34 | Steam | |
5 | Wish | 35 | Etsy |
6 | Walmart | 36 | |
7 | Zalo | 37 | ChatGPT |
8 | Shopee | 38 | AliExpress |
9 | eBay | 39 | loot.tv |
10 | Coinlist | 40 | Alibris |
11 | Lazada | 41 | Shopify |
12 | Tokopedia | 42 | stockx |
13 | Bestbuy | 43 | Tokopedia |
14 | Gmail | 44 | Bumble |
15 | 45 | Badoo | |
16 | Tinder | 46 | Vinted |
17 | Telegram | 47 | Allegro.pl |
18 | 48 | Seeking | |
19 | Youtube | 49 | SilverSingles |
20 | Tiktok | 50 | Eharmony |
21 | 51 | Depop | |
22 | Adidas | 52 | EliteSingles |
23 | Nike | 53 | Joom |
24 | Supreme | 54 | Kikuu |
25 | SoleSlayer | 55 | Jumia |
26 | SupremeSlayer | 56 | Konga |
27 | BetterNikeBot | 57 | Ozon |
28 | EasyCop Bot | 58 | Newegg |
29 | FootLocker | 59 | Temu |
30 | Dashe | 60 | Mercado libre |
参数soft对应环境表
soft | 环境 | soft | 环境 |
|---|---|---|---|
1 | 通用 | 303 | 华为云 |
201 | 紫鸟 | 399 | 其他云服务器/云手机 |
202 | MoreLogin | 401 | 小火箭 |
203 | Adspower | 402 | V2ray |
204 | 比特 | 403 | wireguard |
205 | Hubstudio | 404 | Andproxy |
209 | 其他指纹浏览器 | 5 | 群控/代码脚本 |
301 | GeeLark | 405 | SaleSmartly |
302 | 阿里云 |
|
|
结果数据
类型:对象 (临时新购订单)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
orderid | string | 未支付订单id | 5283163557995843913770 |
price | int | 价格,单位分 | 1000 |
unit | string | 价格对应的套餐单位 | 端口/1天 |
currency | string | 货币单位 | ¥ |
balance | int | 当前账户余额,单位分 | 20000 |
uncount | int | 账户余额中未扣除流量费,单位分 | 0 |
cost | int | 支付订单需立即扣除金额,单位分 | 1000 |
EXAMPLE:
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会过期,不可进行支付确认
只可以对未过期线路进行续订
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
p | int | 线路id | 2300790 |
d | int | 购买的月数(30个自然日作为一个标准月长度)[可选参数] | 3,表示该 IP购买3个月(90天)使用期 |
结果数据
类型:对象 (临时续费订单)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
orderid | string | 未支付订单id | 5283163558121643316178 |
price | int | 价格,单位分 | 1000 |
unit | string | 价格对应的套餐单位 | 端口/1天 |
currency | string | 货币单位 | ¥ |
balance | int | 当前账户余额,单位分 | 20000 |
uncount | int | 账户余额中未扣除流量费,单位分 | 0 |
cost | int | 支付订单需立即扣除金额,单位分 | 1000 |
days | int | 续订天数 | 1 |
autorenew | int | 该线路当前续订配置 | 0:跟随用户全局续订策略 |
EXAMPLE:
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}
接口:/checkbr?ps=线路id,线路id
接口生成一张未支付续订订单,并返回订单费用信息
未支付订单的有效期为10分钟,10分钟后订单id会过期,不可进行支付确认
只可以对未过期线路进行批量续订
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
ps | int | 线路id,英文逗号分隔,最多50个 | 2300790,2300791,2300792 |
d | int | 购买的月数(30个自然日作为一个标准月长度), | 3,表示该 IP购买3个月(90天)使用期 |
结果数据
类型:对象 (临时续费订单)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
orderid | string | 未支付订单id | 5283163558121643316179 |
price | int | 价格,单位分 | 20000 |
unit | string | 价格对应的套餐单位 | 端口/90天 |
currency | string | 货币单位 | ¥ |
balance | int | 当前账户余额,单位分 | 548 |
cost | int | 支付订单需立即扣除金额,单位分 | 14904 |
days | int | 续订天数 | 90 |
EXAMPLE:
PHP示例: '/checkbr?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ps=2300790,2300791,2300792&ts=1609430400', '1234567ABCDEFG', false)).'&ps=2300790,2300791,2300792&ts=1609430400'
示例结果: /checkbr?accessid=1&signature=ZDI0ZjYxODI5MTIzMDViODY0ZTI0YWJhYzUxZDIwNGEyMjEwM2EzMw==&ps=2300790,2300791,2300792&ts=1609430400{"success":true,"data":{"orderid":"5283163558121643316179","balance":548,"price":20000,"cost":14904,"days":90,"unit":"端口/90天","currency":"¥"},"msg":"操作成功","code":0}
接口:/checkt?to=目标用户ID&p=分发套餐&n=分发数量
该接口生成一张未处理的流量分发订单,并返回分发详细信息
流量分发订单不会产生费用,一旦支付,对应流量会从代理账户扣除,并增加到对应的子账户
未处理订单的有效期为10分钟,10分钟后订单id会过期,不可进行支付确认
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
to | int | 目标用户ID | 12345678 |
p | int | 分发套餐 | 1:1GB初级套餐 |
n | int | 分发数量,p=1,n=5表示 分发5个1G套餐,就是5G | 1 |
toun | string | 目标用户名(如果非代理名下用户需要验证)[可选参数] | hello |
结果数据
类型:对象 (临时分发订单)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
orderid | string | 未处理订单id | 5283163557995843913770 |
package | object | 流量包套餐对象 | {"id":1,"name":"初级套餐","traffic":1,"threads":30,"period":30,"rawprice":5800} |
currency | string | 货币单位 | ¥ |
amount | int | 分发数量 | 1 |
流量包套餐规格对象
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
id | int | 套餐id | 1 |
name | string | 套餐名称 | 初级套餐 |
traffic | float | 套餐包含的流量,单位GB | 1 |
threads | int | 套餐包含的独立线路数量限制 | 30 |
period | int | 套餐有效期,单位天 | 30 |
rawprice | int | 套餐原价,单位分 | 5800 |
EXAMPLE:
PHP示例: '/checkt?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'to=12345678&p=1&n=1&ts=1609430400', '1234567ABCDEFG', false)).'&to=12345678&p=1&n=1&ts=1609430400'
示例结果: /checkt?accessid=1&signature=ZmI0Nzk1NDFmYzgyZDUzNjg4ZjFiZTMxMzFkYmI5NzY1ODdiMTY1NQ==&to=12345678&p=1&n=1&ts=1609430400{"success":true,"data":{"orderid":"2687711168327639650112287","package":{"id":1,"name":"初级套餐","traffic":1,"threads":30,"period":30,"rawprice":5800},"currency":"¥","amount":1},"msg":"操作成功","code":0}
流量分发(子账密模式)
接口:/checkt?to=目标用户ID&n=分发流量&type='deliver'/'recycle'
该接口生成一张未处理的流量分发订单,并返回分发详细信息
流量分发订单不会产生费用,一旦支付,对应流量会从代理账户扣除,并增加到对应的子账户
未处理订单的有效期为10分钟,10分钟后订单id会过期,不可进行支付确认
仅子帐密代理账户可以调用该接口
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
to | int | 目标用户ID | 12345678 |
n | int | 分发流量,单位为MB | 777 |
toun | string | 目标用户名(如果非代理名下用户需要验证)[可选参数] | hello |
type | string | type=deliver,表示可以给子帐密任意分配流量 | deliver |
结果数据
类型:对象 (临时分发订单)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
orderid | string | 未处理订单id | 80256211748592122978972662 |
package | object | 流量包套餐对象 | {"id":"97","name":"流量分发","traffic":"0.001","threads":"0","period":"1","rawprice":"0"},"currency":"¥","amount":777} |
currency | string | 货币单位 | ¥ |
amount | int | 分发数量 | 777 |
EXAMPLE:
PHP示例: '/checkt?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'to=12345678&n=100&ts=1609430400', '1234567ABCDEFG', false)).'&to=12345678&n=100&ts=1609430400'
示例结果: /checkt?accessid=1&signature=ZmI0Nzk1NDFmYzgyZDUzNjg4ZjFiZTMxMzFkYmI5NzY1ODdiMTY1NQ==&to=12345678&n=100&ts=1609430400{"success":true,"data":{"orderid":"80256211748592122978972662","package":{"id":"97","name":"流量分发","traffic":"0.001","threads":"0","period":"1","rawprice":"0"},"currency":"¥","amount":777},"msg":"操作成功","code":0}
流量包套餐规格对象
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
id | int | 套餐id | 1 |
name | string | 套餐名称 | 初级套餐 |
traffic | float | 套餐包含的流量,单位GB | 1 |
threads | int | 套餐包含的独立线路数量限制 | 30 |
period | int | 套餐有效期,单位天 | 30 |
rawprice | int | 套餐原价,单位分 | 5800 |
EXAMPLE:
PHP示例: '/checkt?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'to=12345678&p=1&n=1&ts=1609430400', '1234567ABCDEFG', false)).'&to=12345678&p=1&n=1&ts=1609430400'
示例结果: /checkt?accessid=1&signature=ZmI0Nzk1NDFmYzgyZDUzNjg4ZjFiZTMxMzFkYmI5NzY1ODdiMTY1NQ==&to=12345678&p=1&n=1&ts=1609430400{"success":true,"data":{"orderid":"2687711168327639650112287","package":{"id":1,"name":"初级套餐","traffic":1,"threads":30,"period":30,"rawprice":5800},"currency":"¥","amount":1},"msg":"操作成功","code":0}
接口:/pay?o=未支付订单id
该接口对未支付订单进行支付确认
未支付订单在支付确认后会生成一张真实订单,并根据订单信息自动分配/续订线路
线路分配为异步操作,一般支付完成后3分钟内会完成线路分配
如果线路分配失败,订单已支付金额会退回账户余额
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
o | string | 未支付订单id | 5283163557995843913770 |
autor | int | 是否默认开启自动续费 [可选参数] | 1:开启自动续费 |
remark | string | 线路备注, 批量购买的时候, 可以同时备注多条线路 [可选参数] | 测试 |
pwdm | string | pwd_mode, 密码模式;值域["system":"系统账密"; "random":"随机账密"] [可选参数] | 默认为:system;随机账密:random |
结果数据
类型:array [int]
描述:真实订单id
示例:462084126
EXAMPLE:
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}
接口:/oiv2?o=订单id
接口返回订单信息
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
o | int | 订单id | 462084126 |
结果数据
类型:对象 (订单信息)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
orderid | int | 订单id | 462084126 |
ordertype | string | 订单类型 | 新购 / 续订 |
days | int | 订单对应产品天数 | 1 |
type | object | 订单所选类型对象 | {"id":2,"name":"RESIDENTIAL","cnname":"住宅端口"} |
geo | object | 订单所选国家对象 | {"id":433,"name":"US","cnname":"美国"} |
region | object | 订单所选地区对象 | {"id":0,"name":"","cnname":""} |
share | string | 订单对应线路共享模式 | dedicated / share |
protocol | string | 订单对应线路协议 | socks5 |
price | int | 单价,单位分 | 1000 |
unit | string | 价格对应的套餐单位 | 端口/1天 |
currency | string | 货币单位 | ¥ |
num | int | 订单购买数量 | 2 |
realnum | int | 订单实际成功购买数量 | 1 |
ports | array [int] | 订单对应线路id数组 | [2300790] |
status | string | 订单状态 | pending:未完成(未支付/订单处理中) |
add_time | string | 订单添加时间戳 | 1609430400 |
类型/地区对象
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
id | int | 类型/国家/地区id | 433 |
name | string | 英文名 | US |
cnname | string | 中文名 | 美国 |
EXAMPLE:
PHP示例: '/oiv2?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'o=462084126&ts=1609430400', '1234567ABCDEFG', false)).'&o=462084126&ts=1609430400'
示例结果: /oiv2?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=页码
接口返回订单信息列表
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
s | int | 查询开始时间戳 | 1633017600 |
e | int | 查询结束时间戳 | 1633622399 |
ot | int | 订单类型 | 0:不限 / 1:新购 / 2:续费 |
st | string | 订单状态 | pending:未完成(未支付/订单处理中) 不传参默认返回全部状态 |
pi | int | 订单关联线路ID | 8888888 |
p | int | 查询页码 | 1 |
psize | int | 单页数据条数 | 单页展示条数10/20/50 |
结果数据
类型:对象 (列表信息)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
page | int | 当前页码 | 1 |
page_size | int | 单页数据条数 | 10 |
total | int | 总数据量 | 13 |
total_page | int | 总分页数 | 2 |
list | array 对象数组 | 结果数据 |
类型:对象 (结果数据)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
orderid | number | 订单id | 897918527 |
ordertype | string | 订单类型 | 续订 |
protocol | string | 线路协议 | socks5 |
share | string | 线路共享模式 | dedicated |
num | number | 下单数量 | 1 |
realnum | number | 实际成功数量 | 1 |
price | number | 价格,单位分 | 20000 |
unit | string | 价格对应的套餐单位 | 端口/30天 |
currency | string | 货币单位 | "¥" |
type | object | 订单所选类型对象 | {"id":2,"name":"RESIDENTIAL","cnname":"住宅端口"} |
geo | object | 订单所选国家对象 | {"id":451,"name":"IT","cnname":"意大利"} |
region | object | 订单所选地区对象 | {"id":0,"name":"","cnname":""} |
status | string | 订单状态 | 订单完成 |
add_time | number | 订单添加时间戳 | 1752553831 |
expire_time | number | 线路过期时间戳 | 1753331431 |
is_commitment | number | 是否签署承诺书 | 1 |
commitment_info | object | 订单所选承诺书对象 | {order_id: 907582626, begin_time: 1752639724, end_time: 1753417323, total_price: 1620,…} |
EXAMPLE:
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":1,"page_size":10,"total":1,"total_page":1,"list":[ {"orderid":907582626,"ordertype":"续订","protocol":"socks5","share":"dedicated","num":1,"realnum":1,"price":3420,"unit":"端口/9天","currency":"¥","type":{"id":4,"name":"ISP","cnname":"静态住宅ISP"},"geo":{"id":566,"name":"US","cnname":"美国"},"region":{"id":0,"name":"","cnname":""},"status":"订单完成","add_time":1752553831,"expire_time":1753331431,"is_commitment":1,"commitment_info": ""}, {"order_id":907582626,"begin_time":1752639724,"end_time":1753417323,"total_price":1620,"unit_price":1620,"ip_cost":675,"bs_bandwidth_cost":945,"out_ips":["217.77.17.20"]}]}, "msg":"操作成功","code":0}
港澳台地区需要先对账号进行实名,才可以使用
该板块介绍快速提取动态家庭住宅IP的方法
提取模式:用户ID-安全策略用户名:安全策略密码-国家ISO码-随机session-IP轮转时间间隔@kookeey网关:1000
提取参数详细说明
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
用户ID | int | 用户ID | 123456789 |
安全策略用户名 | string | 用户全局安全策略的用户名 | abcdefg |
安全策略密码 | string | 用户全局安全策略的用户密码 | abcdefg1234 |
国家ISO码 | string | 国家标准ISO码,支持精细地区定位 | US |
随机session | string | 随机字符串,8位[可选参数] | 12345678 |
IP轮转时间间隔 | string | IP轮转时间间隔[可选参数] | 5m:5分钟自动轮转 |
kookeey网关 | string |
| gate.kookeey.info |
国家ISO码传参规则
格式 | 示例 | 说明 |
|---|---|---|
{countrycode} | US | 国家级定位 |
{countrycode}_{regioncode} | US_California | 州级定位 |
{countrycode}_{regioncode}_city_{citycode} | US_California_city_LosAngeles | 城市级定位:如果城市码错误,则采用州级定位,如果州码错误,则采用国家级别定位 |
{countrycode}_city_{citycode} | US_city_LosAngeles | 城市级定位:相当于 US_random_city_LosAngeles |
可选kookeey网关
默认网关 | gate.kookeey.info |
东亚用户优化网关 | gate-hk.kookeey.info |
美加用户优化网关 | gate-us.kookeey.info |
东南亚用户优化网关 | gate-sea.kookeey.info |
欧洲用户优化网关 | gate-eu.kookeey.info |
英国用户优化网关 | gate-gb.kookeey.info |
澳洲用户优化网关 | gate-au.kookeey.info |
南亚用户优化网关 | gate-in.kookeey.info |
泰国用户优化网关 | gate-th.kookeey.info |
日本用户优化网关 | gate-jp.kookeey.info |
EXAMPLE:
提取示例
US,每次请求切换:123456789-abcdef:12345678-US@gate.kookeey.info:1000
全球混播,每次请求切换:123456789-abcdef:12345678-global@gate.kookeey.info:1000
US,粘性使用:123456789-abcdef:12345678-US-71261427@gate.kookeey.info:1000
US,每5分钟自动切换:123456789-abcdef:12345678-US-86822206-5m@gate.kookeey.info:1000
US,每1小时自动切换:123456789-abcdef:12345678-US-86822206-1h@gate.kookeey.info:1000
US_California,粘性使用:123456789-abcdef:12345678-US_California-86822206@gate.kookeey.info:1000
US_California_city_LosAngeles,粘性使用:123456789-abcdef:12345678-US_California_city_LosAngeles-86822206@gate.kookeey.info:1000
接口:clientapi/pickdynamicipsbyw?g=动态地区id&n=提取数量&t=白名单类型
该接口会返回白名单模式下提取的线路(服务器IP:端口)
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
g | int | 动态地区id | 433 |
n | int | 提取数量,1-100,默认10 | 10 |
t | int | 白名单类型 | 2=>动态住宅 |
EXAMPLE:
PHP示例: '/pickdynamicipsbyw?accessid=1234&signature='.base64_encode(hash_hmac("sha1", 'g=433&n=1&t=2&ts=1609430400', '1234567ABCDEFG', false)).'&g=433&n=1&t=2&ts=1609430400’示例结果: /clientapi/pickdynamicipsbyw?accessid=1&signature=YmJmMDhlMTg4Njc3YzA3ZTViNmE0MTNlNjRiZTI1MTVlZGYwNzcxZQ==&g=433&n=2&t=2&ts=1609430400{"success":true,"data":["107.150.111.223:7135","118.194.234.125:7500","118.194.233.132:7442"],"msg":"操作成功","code":0}
港澳台地区需要先对账号进行实名,才可以使用
该板块介绍主动切换提取模式动态ip的出口ip,操作方法:拼接一串url链接,可在第三方软件上切换url来达到切换出口ip的目的
接口路径:/clientapi/chgsessionip?uid=用户ID&token=开发者token&geo=国家ISO码
提取参数详细说明:
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
uid | int | 用户id | 5201314 |
token | string | 开发者token的MD5加密格式(32位[小]) | abcdefg |
geo | string | 国家的ISO码 | US /US_Washington |
session | string | 需要切换的session [可选参数] | 12344524567 |
client_ip | string | 白名单模对应的客户端IP [可选参数] | 127.0.0.1 |
port | string | 白名单模式对应的线路IP:端口 [可选参数] | 102.113.11.2:1234 |
EXAMPLE:
账密模式需要传 session : https://kookeey.com/clientapi/chgsessionip?uid=5288&token=abcdefg&geo=US&session=12344524567白名单模式需传客户端IP和连接网关端口号:https://kookeey.com/clientapi/chgsessionip?uid=5288&token=abcdefg&geo=US&client_ip=127.0.0.1&port=102.113.11.2:1234
相关数据结构:[类型/地区对象 ]
ID | 描述 |
|---|---|
1 | 静态数据中心 |
2 | 动态家庭住宅 |
4 | 静态ISP住宅 |
sp | 加速入口城市 |
|---|---|
0 | 原生 |
1 | 香港 |
2 | 曼谷 |
5 | 洛杉矶 |
接口:/pi?p=线路id
接口返回线路信息
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
p | int | 线路id | 462084126 |
sa | int | 是否附加每个线路账密认证信息[可选参数] | 1:是 |
c | int | 是否附加线路出口IP信息[可选参数] | 1:是 |
结果数据
类型:对象 (线路信息)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
portid | int | 线路id | 2300790 |
protocol | string | 线路协议 | socks5 |
proxyip | string | ip | 107.151.187.174 |
proxyport | int | 端口 | 64825 |
share | string | 线路共享模式 | dedicated / share |
rotate_mode | int | ip切换模式 | 1:粘性 / 2:30min / 3:10min / 4:5min |
next_changeip_time | int | 动态线路允许手动切换IP的时间戳 | 1609430400 |
type | object | 订单所选类型对象 | {"id":4,"name":"ISP","cnname":"静态住宅ISP"} |
geo | object | 订单所选国家对象 | {"id":566,"name":"US","cnname":"美国"} |
region | object | 订单所选地区对象 | {"id":0,"name":"","cnname":""} |
status | string | 线路状态 | 正常( Normal)/停用( Pause)/已过期(Expired)/余额不足(Insufficient Balance)/异常(Exception) |
autorenew | int | 该线路当前续订配置 | 0:跟随用户全局续订策略 |
default_autorenew | int | 该类型线路用户全局续订策略 | 0:不自动续订 |
add_time | int | 线路添加时间戳 | 1609430400 |
expire_time | int | 线路过期时间戳 | 1635667562 |
ip | string | 该线路当前出口IP | 192.168.1.1 |
defaultauth | int | 该线路是否使用全局连接账密 | 0:否,线路使用独立账密 |
authstr | string | 该线路连接账密 | 连接用户名:连接密码(如:aaaaaaaa:bbbbbbbb) |
remark | string | 该线路备注 | 测试用 |
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=页码
接口返回线路信息列表
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
t | int | 线路类型 | 2 |
g | int | 地区id[可选参数] | 433 |
p | int | 查询页码 | 1 |
s | int | 线路状态[可选参数] | 1:正常 |
a | string | 线路账密[可选参数] | 查询特定 用户名/密码 认证的线路,支持模糊搜索 |
o | int | 关联订单id[可选参数] | 111111111,精确匹配 |
ip | string | 出口/线路 IP查询线路,支持模糊搜索[可选参数] | 1.2.3.4 / 1.2.3 ,支持模糊搜索 |
c | int | 是否附加线路出口IP信息[可选参数] | 1:是 |
sa | int | 是否附加每个线路账密认证,带宽,udp等附加信息[可选参数] | 1:是 |
结果数据
类型:对象 (列表信息)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
page | int | 当前页码 | 1 |
page_size | int | 单页数据条数 | 10 |
total | int | 总数据量 | 2 |
total_page | int | 总分页数 | 1 |
list | array 对象数组 | 结果数据 |
类型:对象 (结果数据)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
portid | int | 线路id | 2070871534 |
proxyip | string | 服务器ip | 102.129.224.117 |
protocol | string | 线路协议 | socks5 |
proxyport | int | 端口 | 28448 |
share | string | 线路共享模式 | dedicated / share |
rotate_mode | int | ip切换模式 | 1:粘性 / 2:30min / 3:10min / 4:5min |
type | object | 订单所选类型对象 | {"id": 1,"name": "STATIC","cnname": "静态数据中心"} |
geo | object | 订单所选国家对象 | {"id": 433,"name": "US","cnname": "美国"} |
region | object | 订单所选地区对象 | {"id": 2174, "name": "Arkansas", "cnname": "阿肯色州"} |
proxydomain | string | 骨干IP对应的域名 | us7.kookeey.info |
spip | string | 加速入口IP | 122.10.197.112 |
spdomain | string | 加速入口IP对应的域名 | sp-hk1.kookeey.info |
spcity | string | 加速入口城市id | 1 |
spcityname | string | 加速入口城市name | 香港 |
spport | string | 加速端口 | 12288 |
status | int | 线路状态 | 正常/停用/已过期/余额不足/异常 |
autorenew | int | 该线路当前续订配置 | 0:跟随用户全局续订策略 |
default_autorenew | int | 该类型线路用户全局续订策略 | 0:不自动续订 |
bandwidth | int | 带宽,单位Mbps,sa=1时返回 | 5 |
add_time | int | 线路添加时间戳 | 1721792804 |
next_changeip_time | int | 动态线路允许手动切换IP的时间戳 | 1609430400 |
expire_time | int | 线路过期时间戳 | 1724384803 |
ip | string | 该线路当前出口IP | 23.20.13.233 |
defaultauth | int | 该线路是否使用全局连接账密 | 0:否,线路使用独立账密 |
authstr | string | 该线路连接账密 | 连接用户名:连接密码(如:aaaaaaaa:bbbbbbbb) |
udp | int | 是否开启udp,1表示开启,0表示关闭 | 0 |
remark | string | 该线路备注 | 测试用 |
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": 1,"total_page": 1,"list": [{"portid": 2070871534,"proxyip": "102.129.224.117","proxyport": 28448,"protocol": "socks5","share": "dedicated","rotate_mode": 0,"type": {"id": 1,"name": "STATIC","cnname": "静态数据中心"},"geo": {"id": 433,"name": "US","cnname": "美国"},"region": { "id": 2174, "name": "Arkansas", "cnname": "阿肯色州"},"autorenew": 0,"default_autorenew": 0,"status": "正常","status_code": 1,"renew_status": 2,"add_time": 1721792804,"next_changeip_time": "-","expire_time": 1724384803,"ip": "23.20.13.233","authstr": "aaaaaaaa:bbbbbbbb","bandwidth": 5,"udp": 0,"backboneip": "102.129.224.117","proxydomain": "us7.kookeey.info","spcity": 1,"spcityname": "香港","spip": "122.10.197.112","spdomain": "sp-hk.kookeey.info","spport": 12288,"defaultauth": 0,"remark": "","purpose":8 }]},"msg": "操作成功","code": 0}
接口:/toggle?p=线路id&s=切换到状态
该接口可以恢复/停用线路
停用操作只是临时限制线路连接,并不能延长线路的过期时间
修改后生效时间为3分钟
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
p | int | 线路id | 2300790 |
s | int | 切换到状态 | 1:开启 |
结果数据
类型: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}
接口:/batchchangestatus?ps=线路id,线路id&s=切换到状态
该接口可以批量恢复/停用线路
停用操作只是临时限制线路连接,并不能延长线路的过期时间
修改后生效时间为3分钟
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
ps | string | 线路id | 2300790,4427674 |
s | int | 切换到状态 | 1:开启 |
结果数据
类型:string
描述:无
PHP示例: '/batchchangestatus?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'p=2300790,4427674&s=1&ts=1609430400', '1234567ABCDEFG', false)).'&p=2300790,4427674&s=1&ts=1609430400'示例结果: /batchchangestatus?accessid=1&signature=SQNhNGI5NjY4ZWU3YjM1MThmZGFkZDE0NGIyMmUxZDZkNTljZWI1Ns==&p=2300790,4427674&s=1&ts=1609430400{"success":true,"data":"","msg":"操作成功","code":0}
接口:/clientapi/checkbatchchangebw?bw=调整带宽的值&ps=线路ids
该接口用于批量调整线路带宽前的预检查,返回每条线路在调整后的带宽、价格和差价等信息。
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
bw | int | 调整的值(带宽大小, 单位:Mbps; -1 为共享带宽包) | 10 |
ps | int,int,int,int | 线路ids(英文逗号分隔) | 2300790,1323780 |
结果数据
类型:对象
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
proxy_id | number | 线路id | 2300790 |
expire_time | number | 线路过期时间戳 | 1703228526 |
current_bandwidth | number | 线路当前带宽 | 5 |
pay_price | number | 调整前单价(单位:分) | 4200 |
to_bandwidth | number | 调整带宽的值 | 10 |
to_price | number | 调整后单价(单位:分) | 9100 |
pay_days | number | 购买天数 | 30 |
left_days | number | 差价天数 | 29 |
need_pay | number | 差价(单位:分) | 4737 |
PHP示例: '/clientapi/checkbatchchangebw?accessid=1&signature='.base64_encode(hash_hmac("sha1",'bw=10&ps=2300790,1323780&ts=1609430400', '1234567ABCDEFG', false)).'&bw=10&ps=2300790,1323780&ts=1609430400'{"success": true,"data": [{"proxy_id": 2300790,"expire_time": 1703228526,"current_bandwidth": 5,"pay_price": 4200,"to_bandwidth": 10,"to_price": 9100,"pay_days": 30,"left_days": 29,"need_pay": 4737},{"proxy_id": 1323780,"expire_time": 1703228526,"current_bandwidth": 5,"pay_price": 4200,"to_bandwidth": 10,"to_price": 9100,"pay_days": 30,"left_days": 29,"need_pay": 4737}],"msg": "操作成功","code": 0}
接口:/release?p=线路id
该接口可以提前释放未过期的动态IP池
按周期计费的线路,释放后会退回未消费的计费周期
动态IP池释放后,连接线路无法找回
仅对动态线路可用
修改后线路会被立刻释放
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
p | int | 线路id | 2300790 |
结果数据
类型: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}
接口:/batchrelease?ps=线路id,线路id,线路id,线路id
该接口可以提前释放未过期的动态IP池
按周期计费的线路,释放后会退回未消费的计费周期
动态IP池释放后,连接线路无法找回
仅对动态线路可用
修改后线路会被立刻释放
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
ps | int,int,int,int | 线路id(英文逗号分隔,最多支持传50个ID) | 2300790,1323780,3295059,1503589 |
结果数据
类型:array [int]
描述:释放成功的线路id
PHP示例: '/batchrelease?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ps=2300790,1323780,3295059,1503589&ts=1609430400', '1234567ABCDEFG', false)).'&ps=2300790,1323780,3295059,1503589&ts=1609430400'示例结果: /batchrelease?accessid=1&signature=ZDMwNDIxNTU0OWMwNjdhNTNiNmJiODY0YzA0YTk5NjQzZGMxYTliOA==&ps=2300790,1323780,3295059,1503589&ts=1609430400{"success":true,"data":[2300790,1323780,3295059,1503589],"msg":"操作成功","code":0}
接口:/rotate?p=线路id&m=目标ip切换周期
该接口可以修改线路的IP切换周期
仅对动态线路可用
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
p | int | 线路id | 2300790 |
m | int | 目标ip切换周期 | 0:粘性;5m,10m,60m…最大值1440m(只能传 0 或者 数字m 的格式) |
结果数据
类型: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=目标续费模式
该接口可以修改线路自动续费模式
如果线路存在自动续费配置,则会覆盖用户全局续订策略
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
p | int | 线路id | 2300790 |
s | int | 目标续费模式 | 1:该线路强制自动续订 |
结果数据
类型: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分钟
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
p | int | 线路id | 2300790 |
n | string | 验证用户名[可选参数] | kookeey (6-16位数字或字母) |
pwd | string | 验证密码[可选参数] | 12345678 (8-24位数字或字母) |
del | int | 删除独立账密[可选参数] | 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分钟
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
p | int | 线路id | 2300790 |
d | string | 查询日期 | 2021-10-01(系统采用东八时区) |
结果数据
类型:对象 (小时统计)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
hour | int | 小时 | 1 |
count | int | 流量统计,单位kb | 2365 |
fee | int | 流量费用,单位分 | 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}
接口:/batchchangeip?ps=线路id,线路id,线路id,线路id
该接口可以申请主动切换批量线路的出口IP
单线路限制切换频率为1次/分钟
切换过程会有连接中断,一般为30s左右
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
ps | int,int,int,int | 线路id(英文逗号分隔,最多支持传50个ID) | 2300790,1323780,3295059,1503589 |
结果数据
类型:array [int]
描述:切换成功的线路id
PHP示例: '/batchchangeip?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ps=2300790,1323780,3295059,1503589&ts=1609430400', '1234567ABCDEFG', false)).'&ps=2300790,1323780,3295059,1503589&ts=1609430400'示例结果: /batchchangeip?accessid=1&signature=ZDMwNDIxNTU0OWMwNjdhNTNiNmJiODY0YzA0YTk5NjQzZGMxYTliOA==&ps=2300790,1323780,3295059,1503589&ts=1609430400{"success":true,"data":[2300790,1323780,3295059,1503589],,"msg":"操作成功","code":0}
接口:/changeremark?p=线路id&r=备注内容
该接口可以设置某条线路的备注
备注长度为1-50个字符
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
p | int | 线路id | 2300790 |
r | string | 备注内容(空值表示删除线路备注) | test |
结果数据
无
PHP示例: '/changeremark?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'p=2300790&r=test&ts=1609430400', '1234567ABCDEFG', false)).'&p=2300790&r=test&ts=1609430400'示例结果: /changeremark?accessid=1&signature=ODZkZjI5MGIyNzA0MGYxMzdiZmUyN2U1MTA2MDJhZTMwNjIyMDRmMQ==&p=2300790&r=test&ts=1609430400{"success":true,"data":"","msg":"操作成功","code":0}
接口:/batchchangeremark?ps=线路id,线路id,线路id,线路id&r=备注内容
该接口可以设置多条线路的备注
备注长度为1-50个字符请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
ps | int,int,int,int | 线路id(英文逗号分隔,最多支持传50个ID) | 2300790,1323780,3295059,1503589 |
r | string | 备注内容(空值表示删除线路备注) | helloworld |
结果数据
无
PHP示例: '/batchchangeremark?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ps=2300790,1323780,3295059,1503589&r=helloworld&ts=1609430400', '1234567ABCDEFG', false)).'&ps=2300790,1323780,3295059,1503589&r=helloworld&ts=1609430400'示例结果: /batchchangeremark?accessid=1&signature=NzA0OTlhZGVjN2EyNjJiY2NiMDhhYjA2YWU5NWVkNjJlZmRlYTc0YQ==&ps=2300790,1323780,3295059,1503589&r=helloworld&ts=1609430400{"success":true,"data":"","msg":"操作成功","code":0}
接口:/ip?p=线路id
该接口可以获取某个线路的当前出口IP. 注意:本接口获取IP 有缓存,适合静态数据中心、静态住宅 ISP线路查询使用。
动态的线路要检验是否切换IP成功,建议使用 https://checkip.amazonaws.com/ 、 https://lumtest.com/myip.json 等第三方的 IP 查询网站。
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
p | int | 线路id | 2300790 |
结果数据
类型: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
该接口返回用户当前的安全策略配置
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
u | int | 开发者ID | 1 |
结果数据
类型:对象
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
openauth | int | 账密验证 | 1:开启 / 2:关闭 |
openwhiteip | int | ip白名单验证 | 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分钟
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
i | string | 验证模式 | openauth:账密验证 / openwhiteip:ip白名单验证 |
t | int | 修改为状态 | 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分钟
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
n | string | 验证用户名 | kookeey (6-16位数字或字母) |
p | string | 验证密码 | 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分钟
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
ip | string | ipv4地址 | 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分钟
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
ip | string | ipv4地址 | 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}
接口:/addpacb?domain=域名
该接口可以把某个域名添加到PAC黑名单中
域名不可包含特殊字符,无需加上 http(s):// ,系统会匹配该域名下的所有子级域名,如配置了google.com,则mail.google.com,accounts.google.com也会在黑名单中
修改后生效时间为3分钟
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
domain | string | 域名 | kookeey.com |
结果数据
类型:string
描述:无
PHP示例: '/addpacb?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'domain=kookeey.com&ts=1609430400', '1234567ABCDEFG', false)).'&domain=kookeey.com&ts=1609430400'示例结果: /addpacb?accessid=1&signature=MjBiOThlNGQ0NDM1MTE2ODg0ZmI2YjljMmNmN2JlOGM2Nzc2MTgxOA==&domain=kookeey.com&ts=1609430400{"success":true,"data":"","msg":"操作成功","code":0}
接口:/delpacb?domain=域名
该接口可以把某个域名从PAC黑名单中移除
域名不可包含特殊字符,无需加上 http(s)://
修改后生效时间为3分钟
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
domain | string | 域名 | kookeey.com |
结果数据
类型:string
描述:无
PHP示例: '/delpacb?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'domain=kookeey.com&ts=1609430400', '1234567ABCDEFG', false)).'&domain=kookeey.com&ts=1609430400'示例结果: /delpacb?accessid=1&signature=MjBiOThlNGQ0NDM1MTE2ODg0ZmI2YjljMmNmN2JlOGM2Nzc2MTgxOA==&domain=kookeey.com&ts=1609430400{"success":true,"data":"","msg":"操作成功","code":0}
接口:/pacb
该接口可以获取当前配置的PAC黑名单列表
请求参数
无
结果数据
类型:string
描述:无
PHP示例: '/pacb?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ts=1609430400', '1234567ABCDEFG', false)).'&ts=1609430400'示例结果: /pacb?accessid=1&signature=ZDk4YmRiYzllYjQzNzhkNjIwMDg1YTQzYzM2NzcwZTQzODQ4ZTNkZQ==&ts=1609430400{"success":true,"data":["kookeey.com"],"msg":"操作成功","code":0}
接口:/addreswip? ip=ipv4地址 & slock=是否开启安全锁
该接口可以把非中国大陆的IPV4的地址添加在白名单内
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
ip | string | IPV4 | 45.153.129.73 |
slock | int | 是否开启安全锁,1表示开启,0表示不开启 | 1 |
结果数据
类型:string
描述:无
PHP示例: '/addreswip?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ip=45.153.129.73&slock=1&ts=1609430400', '1234567ABCDEFG', false)).'&ip=45.153.129.73&slock=1&ts=1609430400'示例结果: /addreswip?accessid=1&signature=MjBiOThlNGQ0NDM1MTE2ODg0ZmI2YjljMmNmN2JlOGM2Nzc2MTgxOA==&ip=45.153.129.73&slock=1&ts=1609430400{"success":true,"data":"","msg":"操作成功","code":0}
接口:clientapi/delreswip?ip=ipv4地址
该接口可以把某个IP从提取模式白名单中移除
修改后生效时间为3分钟
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
ip | string | ipv4地址 | 192.168.1.1 |
结果数据
类型:string
描述:无
PHP示例: '/delreswip?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ip=192.168.1.1&ts=1609430400', '1234567ABCDEFG', false)).'&ip=192.168.1.1&ts=1609430400'示例结果: /delreswip?accessid=1&signature=ZTBlYTk4NTljMzViYzIzODE4M2QzMDU4ZTNhZDMwMmQ2OWZkMzMyNw==&ip=192.168.1.1&ts=1609430400{"success":true,"data":"","msg":"操作成功","code":0}
动态提取模式-白名单IP备注
接口:clientapi/remarkreswip
该接口可以把白名单IP设置备注
请求参数
Headers:
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
Content-Type | 无 | 无 | application/x-www-form-urlencoded |
Body:
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
ip | T- 文本 | 白名单IP | 192.168.1.0 |
remark | T- 文本 | 备注信息,允许为空 | 123 |
结果数据
类型:string
描述:无
{"success":true,"data":"","msg":"操作成功","code":0}
动态提取模式-获取白名单IP列表
接口:clientapi/reswip
该接口可以获取到已添加的白名单IP列表
请求参数
无
结果数据
类型:对象
描述:无
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
ip | String | 白名单IP | 191.168.1.0 |
slock | int | 是否开启安全锁(已开通 1,未开通0) | 1 |
in_risk | boolean | 是否存在安全风险 | false |
status | int | 0未验证,1正常,2安全风险自动停用,3用户手动停用,4认证过期 | 1 |
2nd_check_rick | boolean | 是否需要二次验证 | false |
add_time | int | 添加时间 | 1723449329 |
identify_time | int | 上次认证时间 | 1723449329 |
last_active_time | int | 上次活跃时间(使用时会自动更新改时间) | 1723449329 |
expire_time | int | 认证过期时间 | 1723449329 |
remark | String | 备注信息 | 1723449329 |
示例结果: clientapi/reswip/?accessid=1&signature=YmJmMDhlMTg4Njc3YzA3ZTViNmE0MTNlNjRiZTI1MTVlZGYwNzcxZQ==&sdate=2024-07-01&edate=2024-07-12&ts=1609430400{"success":true,"data":[{"ip":"192.168.1.1","slock":0,"in_risk":false,"status":3,"2nd_check_rick":false,"add_time":1723449329,"identify_time":1723449329,"last_active_time":1723449329,"expire_time":1723449329,"remark":"111"}],"msg":"操作成功","code":0}
接口:/authreswiplink? ip=ipv4地址
该接口会返回一条验证链接,链接有效期15分钟
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
ip | string | IPV4 | 45.153.129.73 |
结果数据
类型:对象
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
data | string | 验证链接(有效期15分钟) | https://www.kookeey.com/clientapi/authreswhiteip?aut=MTUwODY2dsafagggdagDE3MjMxNzYxNTYuMTEyNw== |
PHP示例: '/authreswiplink?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ip=45.153.129.73&ts=1609430400', '1234567ABCDEFG', false)).'&ip=45.153.129.73&ts=1609430400'示例结果: /authreswiplink?accessid=1&signature=MjBiOThlNGQ0NDM1MTE2ODg0ZmI2YjljMmNmN2JlOGM2Nzc2MTgxOA==&ip=45.153.129.73&ts=1609430400{ "success": true, "data": "https://www.kookeey.com/clientapi/authreswhiteip?aut=MTUwODY2dsafagggdagDE3MjMxNzYxNTYuMTEyNw==", "msg": "操作成功", "code": 0 }
接口:clientapi/resauth
该接口会获取线路的用户名与密码信息
请求参数
无
结果数据
类型:string
描述:无
PHP示例: '/resauth?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ts=1609430400', '1234567ABCDEFG', false)).'&ts=1609430400'示例结果: /resauth?accessid=1&signature=ZDk4YmRiYzllYjQzNzhkNjIwMDg1YTQzYzM2NzcwZTQzODQ4ZTNkZQ==&ts=1609430400{"success": true,"data": {"authname": "123456abc","authpwd": "123456abc"},"msg": "操作成功","code": 0}
接口:clientapi/chgresauth?n=用户名&p=密码
该接口会修改动态提取模式线路的用户名与密码
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
n | string | 用户名 | 123456abc(6-16位数字或字母) |
p | string | 密码 | 123456abc(8-24位数字或字母) |
结果数据
类型:string
描述:无
PHP示例: '/chgresauth?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'n=kookeey&p=123456abc&ts=123456abc', '1234567ABCDEFG', false)).'&n=kookeey&p=123456abc&ts=123456abc'示例结果: /chgresauth?accessid=1&signature=YmJmMDhlMTg4Njc3YzA3ZTViNmE0MTNlNjRiZTI1MTVlZGYwNzcxZQ==&n=123456abc&p=123456abc&ts=1609430400{"success": true,"data": "","msg": "操作成功","code": 0}
接口:/info?u=开发者ID
该接口返回用户当前的余额信息
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
u | int | 开发者ID | 1 |
结果数据
类型:对象
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
balance | int | 当前账户余额,单位分 | 548 |
uncount | int | 账户余额中未扣除流量费,单位分 | 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}
接口:/package
该接口返回当前用户的动态套餐余额信息
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
u | int | 开发者ID | 1 |
结果数据
类型:对象
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
package | object | 流量包套餐对象 | {"id":1,"name":"初级套餐","traffic":1,"threads":30,"period":30,"rawprice":5800} |
traffic_left | float | 当前剩余可用流量,单位GB | 1 |
traffic_total | float | 当前套餐下充值流量总额,单位GB | 1 |
thread_total | float | 当前套餐可用独立线路总额 | 30 |
thread_left | int | 当前剩余可用独立线路限制 | 30 |
expire_time | int | 套餐到期时间戳 | 1685869185 |
PHP示例: '/package?accessid=1&signature='.base64_encode(hash_hmac("sha1",
'u=1&ts=1609430400', '1234567ABCDEFG', false)).'&u=1&ts=1609430400'
示例结果:
/package?accessid=1&signature=YWJjNDkyM2M2YTYyOGEyZTIwMzAyOWIyNzliYTkzNmI5Zjg2NTJkZg==&u=1&ts=1609430400
{"success":true,"data":{"package":{"id":1,"name":"初级套餐","traffic":1,"threads":30,"period":30,"rawprice":5800},"traffic_left":1,"traffic_total":1,"thread_total":30,"thread_left":30,"expire_time":1685869185},"msg":"操作成功","code":0,"debug_log":[]}
接口: /clientapi/tdetail ?sdate=查询开始日期&edate=查询结束日期&gb=d
该接口可查询该账号以及子账号的流量使用详情记录
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
sdate | string | 查询开始日期 | 2025-03-11 |
edate | string | 查询结束日期 | 2025-03-11 |
page | int | 页码[可选参数] | 1 |
psize | int | 每页数量 (10,20,30,50),默认10[可选参数] | 10 |
gb | string | 时间聚合类型,d=天,h=小时 | “d” |
gb2 | string | 详细信息聚合,可选 geo=>国家, region=>二级地区,mode=>使用模式,proxy=>线路id[可选参数] | geo,mode,proxy,region |
subid | String | 账号id,-1表示主账号+子账号,不传或0默认只展示主账号数据[可选参数] | -1 |
结果数据
类型:string
描述:对象 (列表信息)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
page | int | 当前页码 | 1 |
page_size | int | 单页数据条数 | 10 |
total | int | 总数据量 | 1 |
total_page | int | 总分页数 | 1 |
time | string | 数据日期 | 2025-03-11 |
uid | number | 用户id | 1234567 |
username | string | 用户名 | kookeey |
geo | string | 国家 | GLOBAL |
count | string | 消耗流量数 | 4.68 GB(单位: KB/MB/GB/TB) |
PHP示例: '/clientapi/tdetail?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'sdate=2023-07-10&edate=2023-07-10&gb=d&ts=1609430400', '1234567ABCDEFG', false)).'&sdate=2023-07-10&edate=2023-07-10&gb=d&ts=1609430400'示例结果: /clientapi/tdetail?accessid=1&signature=YmJmMDhlMTg4Njc3YzA3ZTViNmE0MTNlNjRiZTI1MTVlZGYwNzcxZQ==&sdate=2023-07-10&edate=2023-07-10&gb=d&ts=1609430400{"success":true,"data":{"page":1,"page_size":10,"total":2,"total_page":1,"list":[{"time":"2025-03-11","uid":1234567,"geo":"GLOBAL","region":"","count":"4.68 GB","username":"kookeey"},{"time":"2025-03-11","uid":1234568,"geo":"GLOBAL","region":"","count":"8.27 GB","username":"kookeey2"}]},"msg":"操作成功","code":0}
接口:clientapi/tdetailex
该接口返回当前用户的动态套餐余额信息
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
sdate | string | 查询开始日期 | 2024-11-1 |
edate | string | 查询结束日期 | 2024-11-11 |
gb | string | 时间聚合类型, | d |
gb2 | string | 详细信息聚合[可选参数] | geo,mode,proxy |
subid | string | 账号id,-1表示主账号+子账号,不传或0默认只展示主账号数据[可选参数] | -1 |
结果数据
该接口无json响应,请求成功后会自动下载 .csv 文件
PHP示例: '/tdetailex?accessid=1&signature='.base64_encode(hash_hmac("sha1",'sdate=2024-11-1&edate=2024-11-11&gb=d&ts=1609430400', '1234567ABCDEFG', false)).'&sdate=2024-11-1&edate=2024-11-11&gb=d&ts=1609430400'
示例结果:/tdetailex?accessid=1&signature=YWJjNDkyM2M2YTYyOGEyZTIwMzAyOWIyNzliYTkzNmI5Zjg2NTJkZg==&sdate=2024-11-1&edate=2024-11-11&gb=d&ts=1609430400
接口:/addaccount?u=用户名&e=用户邮箱&md5p=md5加密后的密码
该接口可以用于创建代理名下的子账户
创建完成的子账户默认为已激活状态,账密可以用于登录用户后台
用户名和邮箱参数会做系统排重,至少需要传一个
仅代理账户可以调用该接口
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
u | string | 用户名[可选参数] | testuser (6-32位数字或字母) |
e | string | 用户邮箱 | test@kookeey.com |
md5p | string | md5加密后的密码 | 3b3e9bf9e01962fe4fb9ef658533392e |
showrepeat | int | 是否显示重复信息[可选参数] | 1:用户重复且重复用户属于该代理名下时,会返回重复用户信息 ≠1: 如果重复会返回重复错误码20004 |
结果数据
类型:对象
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
id | int | 用户ID | 12345678 |
token | string | 用户的开发者token | 1234567ABCDEFG |
repeat | int | 是否重复用户 | 1:该用户名在该代理名下已经存在;0:该用户名为代理新用户 仅在showrepeat=1时会显示该参数,如showrepeat≠1,重复用户会返回 20004错误码 |
PHP示例: '/addaccount?accessid=1&signature='.base64_encode(hash_hmac("sha1",
'u=testuser&e=test@kookeey.com&md5p=3b3e9bf9e01962fe4fb9ef658533392e&ts=1609430400', '1234567ABCDEFG',
false)).'&u=testuser&e=test@kookeey.com&md5p=3b3e9bf9e01962fe4fb9ef658533392e&ts=1609430400'
示例结果:
/addaccount?accessid=1&signature=NjkyNTdkNTRmODhhZDlhOWE2Y2U4ZDI2ZmVkYjkzOGJmOGYyMmYyNw==&u=testuser&e=test@kookeey.com&md5p=3b3e9bf9e01962fe4fb9ef658533392e&ts=1609430400
{"success":true,"data":{"id":12345678,"token":"1234567ABCDEFG","repeat":0},"msg":"操作成功","code":0}
接口:clientapi/subaccounts
该接口可以获取当前账号的子账号列表
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
page | int | 页码[可选参数] | 1 |
psize | int | 单页数据条数[可选参数] | 10 |
结果数据
类型:对象
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
page | int | 页码 | 1 |
page_size | int | 单页数据条数 | 10 |
total | int | 总数据量 | 2 |
total_page | int | 总分页数 | 1 |
list | object [] | 对象数组 | [{对象数组},{对象数组}...] |
uid | int | 用户id | 1234567 |
authname | String | 安全策略默认账号 | 1dfd7584 |
authpwd | String | 安全策略默认密码 | 2dfq7584 |
status | int | 状态:1 有效,2 已删除,3 已失效(token刷新) | 1 |
dc_proxys | int | 数据中心代理数 | 10 |
isp_proxys | int | 静态住宅代理数 | 15 |
traffic_left | int | 流量余额 | 1024 |
expire_time | int | 流量到期时间 | 1748952407 |
remark | String | 备注 | 111 |
示例结果:
/subaccounts?accessid=4412414&signature=MDBhMGZQODQ5YzYzlTc1ODNhYTc1OGIwOWVhMGFlNTNhYzJiZDRiZQ==&page=1&page_size=10&ts=1745062690接口:/delsub
该接口可以删除子账号绑定关系
请求参数
Headers:
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
Content-Type | 无 | 无 | application/x-www-form-urlencoded |
Body:
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
to_uid | T- 文本 | 用户id | 无 |
结果数据
无
接口:clientapi/tchglog?sdate=查询开始日期&edate=查询结束日期
该接口查询该账号下流量变更详情记录
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
sdate | string | 查询开始日期 | 2024-07-01 |
edate | string | 查询结束日期 | 2024-07-12 |
page | int | 页码[可选参数] | 1 |
psize | int | 每页数量 (10,20,30,50),默认10[可选参数] | 10 |
t | string | 类型,'use','buy','send',不传默认全部类型[可选参数] |
|
结果数据
类型:string
描述:对象 (列表信息)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
page | int | 当前页码 | 1 |
page_size | int | 单页数据条数 | 10 |
total | int | 总数据量 | 3 |
total_page | int | 总分页数 | 1 |
list | array 对象数组 | 结果数据 |
PHP示例: '/tchglog?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'sdate=2023-07-10&edate=2023-07-10&ts=1609430400', '1234567ABCDEFG', false)).'&sdate=2024-07-01&edate=2024-07-12&ts=1609430400'示例结果: /tchglog?accessid=1&signature=YmJmMDhlMTg4Njc3YzA3ZTViNmE0MTNlNjRiZTI1MTVlZGYwNzcxZQ==&sdate=2024-07-01&edate=2024-07-12&ts=1609430400{ "success": true, "data": {"page": 1, "page_size": 10, "total": 10, "total_page": 1,"list":
[ {"date_time": "2024-07-12 14:56:19", "type": "send","amount": "-1 GB","after": "953.65 TB","remark": "ToUid#6465720" },
{"date_time": "2024-07-05 23:59:59","type": "use","amount": "6.45 TB","after": "12.97 TB","remark": "Date#2024-07-05"},
{"date_time": "2024-07-01 08:53:52","type": "buy", "amount": "20 TB", "after": "20 TB","remark": "" }]
}, "msg": "操作成功", "code": 0 }
1、新增 安全策略 的 动态提取模式-新增白名单IP 和 动态提取模式-获取白名单IP验证链接
5、新增结果码 20004 、 20005 、 40015 、 40016
4、[线路信息对象] 结构新增附加属remark (只针对添加可选参数sa的请求)
2、[地区查询接口返回对象] 结构新增附加属性child (只针对添加可选参数c的请求,不新增参数时保持原结构不变)
2、[线路信息对象] 结构新增附加属性authstr和defaultauth (只针对添加可选参数sa的请求,不新增参数时保持原结构不变)
API请求路径为: https://www.kkoip.com/
所有请求采用 HTTP GET 方式
请求固定包含accessid,signature和ts3个参数
单账户的请求频率限制为 10 qps/s
https://kkoip.com/方法名?accessid=开发者ID&signature=参数字符串和时间戳的签名值&ts=请求发起时间戳(秒)EXAMPLE:
https://kkoip.com/stock?accessid=1&signature=ZDQyNmExY2FiOWZhNDdiMjAzNTYyYmFhZDZmMWIyNzM4N2FjM2JmMA==&g=433&ts=1609430400接口:/security?u=开发者ID
该接口返回用户当前的鉴权账密配置
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
u | int | 开发者ID | 1 |
结果数据
类型:对象
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
authname | string | 鉴权账号 | kookeey |
authpwd | string | 鉴权密码 | usertest |
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":{"authname":kookeey,"authpwd":usertest},"msg":"操作成功","code":0}
接口:/clientapi/chgsecurity?n=验证用户名&p=验证密码
该接口可以修改用户的鉴权密码
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
n | string | 验证用户名 | 123456(6-16位数字或字母) |
p | string | 验证密码 | ABCDEFGH(8-24位数字或字母) |
结果数据
类型:string
描述:无
PHP示例: '/chgsecurity?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'n=123456&p=ABCDEFGH&ts=1609430400', '1234567ABCDEFG', false)).'&n=123456&p=ABCDEFGH&ts=1609430400'示例结果: /chgsecurity?accessid=1&signature=YmJmMDhlMTg4Njc3YzA3ZTViNmE0MTNlNjRiZTI1MTVlZGYwNzcxZQ==&n=123456&p=ABCDEFGH&ts=1609430400{"success":true,"data":"","msg":"操作成功","code":0}
接口:/clientapi/addwip? ip=ipv4地址 & slock=是否开启安全锁
该接口可以把IPV4的地址添加在白名单内
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
ip | string | IPV4 | 45.153.129.73 |
slock | int | 是否开启安全锁,1表示开启,0表示不开启 | 1 |
结果数据
类型:string
描述:无
PHP示例: '/addwip?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ip=45.153.129.73&slock=1&ts=1609430400', '1234567ABCDEFG', false)).'&ip=45.153.129.73&slock=1&ts=1609430400'示例结果: /addwip?accessid=1&signature=MjBiOThlNGQ0NDM1MTE2ODg0ZmI2YjljMmNmN2JlOGM2Nzc2MTgxOA==&ip=45.153.129.73&slock=1&ts=1609430400{"success":true,"data":"","msg":"操作成功","code":0}
接口:/clientapi/authwiplink? ip=ipv4地址
该接口会返回一条验证链接,链接有效期15分钟
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
ip | string | IPV4 | 45.153.129.73 |
结果数据
类型:对象
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
data | string | 验证链接(有效期15分钟) | https://www.kookeey.com/clientapi/authreswhiteip?aut=MTUwODY2dsafagggdagDE3MjMxNzYxNTYuMTEyNw== |
PHP示例: '/authwiplink?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ip=45.153.129.73&ts=1609430400', '1234567ABCDEFG', false)).'&ip=45.153.129.73&ts=1609430400'示例结果: /authwiplink?accessid=1&signature=MjBiOThlNGQ0NDM1MTE2ODg0ZmI2YjljMmNmN2JlOGM2Nzc2MTgxOA==&ip=45.153.129.73&ts=1609430400{ "success": true, "data": "https://www.kookeey.com/clientapi/authreswhiteip?aut=MTUwODY2dsafagggdagDE3MjMxNzYxNTYuMTEyNw==", "msg": "操作成功", "code": 0 }
接口:/clientapi/wpickip? g=动态地区id&n=提取数量
该接口会返回提取代理线路,用户需要已拥有已验证的白名单IP,才可获得数据
请求参数:
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
g | int | 动态地区id | 433 |
n | int | 提取数量,1-100,默认10 | 2 |
结果数据
类型:对象
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
data | string[] | 线路列表 | ["112.118.111.111:7244", |
PHP示例: '/wpickip?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'g=433&n=2&ts=1609430400', '1234567ABCDEFG', false)).'&g=433&n=2&ts=1609430400'示例结果: /wpickip?accessid=1&signature=MjBiOThlNGQ0NDM1MTE2ODg0ZmI2YjljMmNmN2JlOGM2Nzc2MTgxOA==&g=433&n=2&ts=1609430400{ "success": true,"data": ["112.118.111.111:7244",“192.168.3.1:7342”],"msg": "操作成功","code": 0 }
接口:/checkcans?to=目标用户ID
该接口检查当前用户是否可以分配流量,并返回验证数据
如果输入用户ID非代理账户下的子账户,则需要添加toun参数输入目标用户名
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
to | string | 目标用户ID | 2 |
toun | string | 目标用户名(如果非代理名下需要验证)[可选参数] | username |
结果数据
类型:string
描述:对象
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
touid | string | 目标用户ID | 2 |
touname | string | 目标用户名(如果非代理名下需要验证)[可选参数] | kookeey |
PHP示例: '/checkcans?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'to=2&ts=1609430400', '1234567ABCDEFG', false)).'&to=2&ts=1609430400'示例结果: /checkcans?accessid=1&signature=YmJmMDhlMTg4Njc3YzA3ZTViNmE0MTNlNjRiZTI1MTVlZGYwNzcxZQ==&to=2&ts=1609430400{"success": true,"data": {"touid": 2,"touname": "kookeey"},"msg": "操作成功","code": 0}
接口:/checkt?to=目标用户ID&n=1
该接口生成分配流量订单,并返回验证数据
如果输入用户ID非代理账户下的子账户,则需要添加toun参数输入目标用户名
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
to | string | 目标用户ID | 2 |
toun | string | 目标用户名(如果非代理名下需要验证)[可选参数] | kookeey |
n | int | 分配的流量,单位GB(最小1) | 10 |
结果数据
类型:string
描述:对象(临时分发订单)
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
orderid | string | 未处理订单ID | 87528875283059704393 |
touid | string | 目标用户ID | 2 |
toun | string | 目标用户名 | kookeey |
balance | string | 当前流量余额,已格式化带单位 | 2.97 TB |
amount | string | 分配的流量,已格式化带单位 | 10 GB |
PHP示例: '/checkt?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'to=2&n=10&ts=1609430400', '1234567ABCDEFG', false)).'&to=2&n=10&ts=1609430400'示例结果: /checkt?accessid=1&signature=YmJmMDhlMTg4Njc3YzA3ZTViNmE0MTNlNjRiZTI1MTVlZGYwNzcxZQ==&to=2&n=10&ts=1609430400{"success": true,"data": {"orderid": "87528875283059704393","touid": 2,"touname": "kookeey","balance": "2.97 TB","amount": "10 GB"},"msg": "操作成功","code": 0}
接口:/pay?o=临时订单ID
该接口对未支付订单进行支付确认
未支付订单在支付确认后会生成一张真实订单,并根据订单信息给指定用户分配流量
如果输入用户ID非代理账户下的子账户,则需要添加toun参数输入目标用户名做二次验证
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
o | string | 临时订单ID | 87528875283059704393 |
结果数据
类型:string
描述:对象 (地区价格)
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
data | string | 订单id | 9882721 |
PHP示例: '/checkt?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'o=87528875283059704393&ts=1609430400', '1234567ABCDEFG', false)).'&o=87528875283059704393&ts=1609430400'示例结果: /checkt?accessid=1&signature=YmJmMDhlMTg4Njc3YzA3ZTViNmE0MTNlNjRiZTI1MTVlZGYwNzcxZQ==&o=87528875283059704393&ts=1609430400{"success": true,"data": "9882721","msg": "操作成功","code": 0}
接口:/tinfo
该接口查询当前账户流量概况
请求参数
描述:无
结果数据
类型:string
描述:对象 (地区价格)
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
balance | int | 剩余可用流量,MB | 23155 |
today_use | int | 今日已用,MB | 44 |
month_use | int | 近30日已用,MB | 190 |
PHP示例: '/tinfo?accessid=1&signature='.base64_encode(hash_hmac("sha1", '&ts=1609430400', '1234567ABCDEFG', false)).'&ts=1609430400'示例结果: /tinfo?accessid=1&signature=YmJmMDhlMTg4Njc3YzA3ZTViNmE0MTNlNjRiZTI1MTVlZGYwNzcxZQ==&ts=1609430400{"success": true,"data": {"balance": 23155,"today_use": 44,"month_use": 190 },"msg": "操作成功", "code": 0}
接口:/clientapi/tdetail?sdate=查询开始日期&edate=查询结束日期&gb=d
该接口可查询该账号以及子账号的流量使用详情记录
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
sdate | string | 查询开始日期 | 2025-03-11 |
edate | string | 查询结束日期 | 2025-03-11 |
page | int | 页码[可选参数] | 1 |
psize | int | 每页数量 (10,20,30,50),默认10[可选参数] | 10 |
gb | string | 时间聚合类型,d=天,h=小时 | “d” |
gbg | int | 是否展示详细地区,1表示展示详细地区[可选参数] | 1 |
subid | String | 账号id,-1表示主账号+子账号,不传或0默认只展示主账号数据[可选参数] | -1 |
mb | int | 值传1,则返回的count单位为MB[可选参数] | 1 |
结果数据
类型:string
描述:对象 (列表信息)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
page | int | 当前页码 | 1 |
page_size | int | 单页数据条数 | 10 |
total | int | 总数据量 | 1 |
total_page | int | 总分页数 | 1 |
time | string | 数据日期 | 2025-03-11 |
uid | number | 用户id | 1234567 |
username | string | 用户名 | kookeey |
geo | string | 国家 | GLOBAL |
count | string | 消耗流量数 | 4.68 GB(单位: KB/MB/GB/TB) |
PHP示例: '/tdetail?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'sdate=2023-07-10&edate=2023-07-10&gb=d&ts=1609430400', '1234567ABCDEFG', false)).'&sdate=2023-07-10&edate=2023-07-10&gb=d&ts=1609430400'示例结果: /tdetail?accessid=1&signature=YmJmMDhlMTg4Njc3YzA3ZTViNmE0MTNlNjRiZTI1MTVlZGYwNzcxZQ==&sdate=2023-07-10&edate=2023-07-10&gb=d&ts=1609430400{"success":true,"data":{"page":1,"page_size":10,"total":2,"total_page":1,"list":[{"time":"2025-03-11","uid":1234567,"geo":"GLOBAL","region":"","count":"4.68 GB","username":"kookeey"},{"time":"2025-03-11","uid":1234568,"geo":"GLOBAL","region":"","count":"8.27 GB","username":"kookeey2"}]},"msg":"操作成功","code":0}
接口:/tchglog?sdate=查询开始日期&edate=查询结束日期
该接口查询该账号下流量变更详情记录
请求参数
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
sdate | string | 查询开始日期 | 2024-07-01 |
edate | string | 查询结束日期 | 2024-07-12 |
page | int | 页码[可选参数] | 1 |
psize | int | 每页数量 (10,20,30,50),默认10[可选参数] | 10 |
t | string | 类型,'use','buy','send',不传默认全部类型[可选参数] |
|
结果数据
类型:string
描述:对象 (列表信息)
属性 | 类型 | 描述 | 示例 |
|---|---|---|---|
page | int | 当前页码 | 1 |
page_size | int | 单页数据条数 | 10 |
total | int | 总数据量 | 3 |
total_page | int | 总分页数 | 1 |
list | array 对象数组 | 结果数据 |
PHP示例: '/tchglog?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'sdate=2023-07-10&edate=2023-07-10&ts=1609430400', '1234567ABCDEFG', false)).'&sdate=2024-07-01&edate=2024-07-12&ts=1609430400'示例结果: /tchglog?accessid=1&signature=YmJmMDhlMTg4Njc3YzA3ZTViNmE0MTNlNjRiZTI1MTVlZGYwNzcxZQ==&sdate=2024-07-01&edate=2024-07-12&ts=1609430400{ "success": true, "data": {"page": 1, "page_size": 10, "total": 10, "total_page": 1,"list":
[ {"date_time": "2024-07-12 14:56:19", "type": "send","amount": "-1 GB","after": "953.65 TB","remark": "ToUid#6465720" },
{"date_time": "2024-07-05 23:59:59","type": "use","amount": "6.45 TB","after": "12.97 TB","remark": "Date#2024-07-05"},
{"date_time": "2024-07-01 08:53:52","type": "buy", "amount": "20 TB", "after": "20 TB","remark": "" }]
}, "msg": "操作成功", "code": 0 }
港澳台地区需要先对账号进行实名,才可以使用
该板块介绍主动切换提取模式动态ip的出口ip,操作方法:拼接一串url链接,可在第三方软件上切换url来达到切换出口ip的目的
接口路径:/clientapi/chgsessionip?uid=用户ID&token=开发者token&geo=国家ISO码
提取参数详细说明
参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
uid | int | 用户id | 5201314 |
token | string | 开发者token的MD5加密格式(32位[小]) | abcdefg |
geo | string | 国家的ISO码 | US /US_Washington |
session | string | 需要切换的session [可选参数] | 12344524567 |
client_ip | string | 白名单模对应的客户端IP [可选参数] | 127.0.0.1 |
port | string | 白名单模式对应的线路IP:端口 [可选参数] | 102.113.11.2:1234 |
EXAMPLE:
账密模式需要传session
https://www.kkoip.com/clientapi/chgsessionip?uid=5201314&token=abcdefg&geo=US&session=12344524567 白名单模式需传客户端IP和连接网关端口号
https://www.kkoip.com/clientapi/chgsessionip?uid=5201314&token=abcdefg&geo=US&client_ip=127