API 调用说明

API调用说明

kookeey-全局

kookeey-静态

kookeey-动态

kkoip

API版本更新

API调用说明 _v2023.12.01

请求

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

所有请求采用 HTTP GET 方式

请求固定包含accessid，signature和ts3个参数

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

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

EXAMPLE:

https://www.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	接口响应状态，`true`表示成功,`false`表示失败
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	该优惠券已被其他订单锁定

kookeey-全局

余额

接口：/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}

订单列表

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

接口返回订单信息列表

请求参数

参数名	类型	描述	示例
s	int	查询开始时间戳	1633017600
e	int	查询结束时间戳	1633622399
ot	int	订单类型	0：不限 / 1：新购 / 2：续费
st	string	订单状态	pending：未完成（未支付/订单处理中） confirm：订单完成 refund：订单退款(购买失败/手动退款) 不传参默认返回全部状态
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}

订单信息

接口：/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：未完成（未支付/订单处理中） confirm：订单完成 refund：订单退款(购买失败/手动退款)
add_time	string	订单添加时间戳	1609430400

类型/地区对象

属性	类型	描述	示例
id	int	类型/国家/地区id	433 0：表示上级地区随机
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}

获取安全策略配置

接口：/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}

添加PAC黑名单

接口：/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}

移除PAC黑名单

接口：/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}

获取PAC黑名单列表

接口：/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}

子账号列表

接口：/subaccounts

该接口可以获取当前账号的子账号列表

请求参数

参数名	类型	描述	示例
page	int	页码[可选参数]	1
psize	int	单页数据条数[可选参数]	10
is_mobile	int	是否显示移动代理信息[可选参数]	1

结果数据

类型：对象

属性	类型	描述	示例
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
mobile_traffic_left	int	移动代理流量余额	1024
mobile_expire_time	int	移动代理流量到期时间	1748952407
remark	String	备注	111

示例结果:/subaccounts?accessid=4412414&signature=YWRmNjBkYTgyZWE5ZGY2NDg1YjViMjIzNzhjM2E4NzE1ZjkxOTIzMw==&page=1&page_size=10&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错误码

属性

类型

描述

示例

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}

删除子账号绑定关系

接口：/delsub

该接口可以删除子账号绑定关系

请求参数

Headers：

参数名	类型	描述	示例
Content-Type	无	无	application/x-www-form-urlencoded

Body:

参数名	类型	描述	示例
to_uid	T- 文本	用户id	无

结果数据

无

kookeey-静态

地区查询

接口：/stockv2?g=父级地区id

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

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

请求参数

参数名	类型	描述	示例
g	int	地区父级id	1：获取所有静态数据中心代理可用国家 2：获取所有动态住宅代理可用国家； 4：获取所有静态住宅 ISP 可用国家； [当前支持的代理类型]

结果数据

类型：对象数组 (地区库存)
接口返回信息中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}]}]}]}

价格查询

接口：/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}

当前可用的代理类型ID

相关数据接口：[地区查询] [线路列表]

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

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

当前可用加速入口城市sp

sp	加速入口城市
0	原生
1	香港
2	曼谷
5	洛杉矶

新购

接口：/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	Twitter	33	Cybersole
4	Facebook	34	Steam
5	Wish	35	Etsy
6	Walmart	36	LinkedIn
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	Whatsapp	45	Badoo
16	Tinder	46	Vinted
17	Telegram	47	Allegro.pl
18	Instagram	48	Seeking
19	Youtube	49	SilverSingles
20	Tiktok	50	Eharmony
21	Google	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}

支付

接口：/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}

续订

接口：/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：跟随用户全局续订策略 1：该线路强制自动续订 2：该线路强制关闭自动续订

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个自然日作为一个标准月长度)，可选值为1-36，不传默认为1[可选参数]	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}

修改自动续费

接口：/prenew?p=线路id&s=目标续费模式

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

如果线路存在自动续费配置，则会覆盖用户全局续订策略

请求参数

参数名	类型	描述	示例
p	int	线路id	2300790
s	int	目标续费模式	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}

线路列表

接口：/pl?t=线路类型&g=地区id&p=页码

接口返回线路信息列表

请求参数

参数名	类型	描述	示例
t	int	线路类型	2 [当前支持的代理类型]
g	int	地区id[可选参数]	433 0 表示不限制
p	int	查询页码	1
s	int	线路状态[可选参数]	1：正常 2：手动停用 3：已过期不传参默认全部状态
a	string	线路账密[可选参数]	查询特定用户名/密码认证的线路，支持模糊搜索
o	int	关联订单id[可选参数]	111111111，精确匹配
ip	string	出口/线路 IP查询线路，支持模糊搜索[可选参数]	1.2.3.4 / 1.2.3 ，支持模糊搜索
c	int	是否附加线路出口IP信息[可选参数]	1：是不传参默认不返回当前出口IP
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 静态线路该值恒为 0
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：跟随用户全局续订策略 1：该线路强制自动续订 2：该线路强制关闭自动续订
default_autorenew	int	该类型线路用户全局续订策略	0：不自动续订 1：自动续订
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：否，线路使用独立账密 1：是
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}

线路信息

接口：/pi?p=线路id

接口返回线路信息

请求参数

参数名	类型	描述	示例
p	int	线路id	462084126
sa	int	是否附加每个线路账密认证信息[可选参数]	1：是不传参默认不返回每个线路账密认证信息
c	int	是否附加线路出口IP信息[可选参数]	1：是不传参默认不返回当前出口IP

结果数据

类型：对象 (线路信息)

属性	类型	描述	示例
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 静态线路该值恒为 1
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：跟随用户全局续订策略 1：该线路强制自动续订 2：该线路强制关闭自动续订
default_autorenew	int	该类型线路用户全局续订策略	0：不自动续订 1：自动续订
add_time	int	线路添加时间戳	1609430400
expire_time	int	线路过期时间戳	1635667562
ip	string	该线路当前出口IP [附加参数] 只有请求时添加对应可选参数才会返回该字段	192.168.1.1 对于状态关闭或者过期的线路，该值恒为 -
defaultauth	int	该线路是否使用全局连接账密 [附加参数] 只有请求时添加对应可选参数才会返回该字段	0：否，线路使用独立账密 1：是
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}

获取IP

接口：/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}

恢复/停用

接口：/toggle?p=线路id&s=切换到状态

该接口可以恢复/停用线路

停用操作只是临时限制线路连接，并不能延长线路的过期时间

修改后生效时间为3分钟

请求参数

参数名	类型	描述	示例
p	int	线路id	2300790
s	int	切换到状态	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}

批量恢复/停用

接口：/batchchangestatus?ps=线路id,线路id&s=切换到状态

该接口可以批量恢复/停用线路

停用操作只是临时限制线路连接，并不能延长线路的过期时间

修改后生效时间为3分钟

请求参数

参数名	类型	描述	示例
ps	string	线路id	2300790,4427674
s	int	切换到状态	1：开启 2：停用

结果数据

类型：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=YmIzZWQ4MzM3M2ZjZmY4ZWZlOGZkNTQzMGMxMTQ0MGMxNjU0MTU5OA==&p=2300790,4427674&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：删除该线路的独立账密，使用全局账密 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}

设置线路备注

接口：/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}

批量修改线路的带宽规格(预检查)

接口：/checkbatchchangebw?bw=调整带宽的值&ps=线路ids

该接口用于批量调整线路带宽前的预检查，返回每条线路在调整后的带宽、价格和差价等信息。

请求参数

参数名	类型	描述	示例
bw	int	调整的值(带宽大小, 单位:Mbps; -1 为共享带宽包) 可调整范围[5, 200]	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示例: '/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}

kookeey-动态

地区查询

价格查询

当前可用的代理类型ID

支付

动态城市查询

接口：/citylist?g=父级地区id

该接口返回已上架城市

请求参数

参数名	类型	描述	示例
g	int	地区父级id	如果传代理类型，则返回该代理类型下所有城市如果传国家id，则返回该国家下所有城市如果传地区id，则返回该地区下所有城市如果传城市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=ZWU2MmE4ZjY0ZjA1Yzc0NmUzOWYwMTZiNzg1MjdlMDZmNDc0OGYyZA==&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}

动态套餐余量

接口：/package

该接口返回当前用户的动态套餐余额信息

请求参数

参数名	类型	描述	示例
t	int	流量类型	2=>动态住宅的套餐情况 3=>移动代理的套餐情况不传默认为2

结果数据

类型：对象

属性	类型	描述	示例
package	object [流量包套餐对象 ]	流量包套餐对象	{"id":1,"type":"2","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,"type":"2","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":[]}

提取动态IP（账密）

港澳台地区需要先对账号进行实名，才可以使用

该板块介绍快速提取动态家庭住宅IP的方法

提取模式：用户ID-安全策略用户名:安全策略密码-国家ISO码-随机session-IP轮转时间间隔@kookeey网关:1000

提取参数详细说明

参数名	类型	描述	示例
用户ID	int	用户ID	123456789
安全策略用户名	string	用户全局安全策略的用户名	abcdefg
安全策略密码	string	用户全局安全策略的用户密码	abcdefg1234
国家ISO码	string	国家标准ISO码，支持精细地区定位	US global表示全球混播港澳台地区需要先对账号进行实名，才可以使用
随机session	string	随机字符串，8位[可选参数]	12345678 不传表示每次请求切换
IP轮转时间间隔	string	IP轮转时间间隔[可选参数]	5m：5分钟自动轮转 1h：1小时自动轮转不传表示粘性
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-th2.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

提取动态IP（白名单）

接口：/pickdynamicipsbyw?g=动态地区id&n=提取数量&t=白名单类型

该接口会返回白名单模式下提取的线路（服务器IP：端口）

请求参数

参数名	类型	描述	示例
g	int	动态地区id	433
n	int	提取数量，1-100，默认10	10
t	int	白名单类型	2=>动态住宅 3=>移动代理

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’

示例结果: /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的方法

提取模式：用户ID-安全策略用户名:安全策略密码-国家ISO码-随机session-IP轮转时间间隔@mobile.kookeey.info:1086

提取参数详细说明

参数名	类型	描述	示例
用户ID	int	用户ID	123456789
安全策略用户名	string	用户全局安全策略的用户名	abcdefg
安全策略密码	string	用户全局安全策略的用户密码	abcdefg1234
国家ISO码	string	国家标准ISO码，支持精细地区定位	US global表示全球混播港澳台地区需要先对账号进行实名，才可以使用
随机session	string	随机字符串，8位[可选参数]	12345678 不传表示每次请求切换
IP轮转时间间隔	string	IP轮转时间间隔[可选参数]	5m：5分钟自动轮转 1h：1小时自动轮转不传表示粘性
mobile.kookeey.info	string	默认网关	mobile.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

可选网关

默认网关	mobile.kookeey.info
美加用户优化网关	mobile-us.kookeey.info

EXAMPLE:

提取示例

US，每次请求切换：123456789-abcdef:12345678-US@mobile.kookeey.info:1086

全球混播，每次请求切换：123456789-abcdef:12345678-global@mobile.kookeey.info:1086

US，粘性使用：123456789-abcdef:12345678-US-71261427@mobile.kookeey.info:1086

US，每5分钟自动切换：123456789-abcdef:12345678-US-86822206-5m@mobile.kookeey.info:1086

US，每1小时自动切换：123456789-abcdef:12345678-US-86822206-1h@mobile.kookeey.info:1086

US_California，粘性使用：123456789-abcdef:12345678-US_California-86822206@mobile.kookeey.info:1086

US_California_city_LosAngeles，粘性使用：123456789-abcdef:12345678-US_California_city_LosAngeles-86822206@mobile.kookeey.info:1086

提取模式 - 添加白名单IP

接口：/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=Y2NiODQ1NDJiZjk3YjQ3YjJkYTkyZjYzMDNmZWE1ODkyNDBlN2VjNg==&ip=45.153.129.73&slock=1&ts=1609430400

{"success":true,"data":"","msg":"操作成功","code":0}

提取模式 - 删除白名单IP

接口：/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备注

接口：/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列表

接口：/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

示例结果: /reswip?accessid=1&signature=ZDUwY2I3MDg4MjU5MDI5NzU2NTUwZGE1YWFkYmM0MDBhOTQ5MjBlOA==&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}

提取模式 - 获取白名单IP验证链接

接口：/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=YzA1NDRiZTNmNTU0YThmYmNkMmUxZjk4NWQxNGExNjZiYTZkNWQwOQ==&ip=45.153.129.73&ts=1609430400

{ "success": true, "data": "https://www.kookeey.com/clientapi/authreswhiteip?aut=MTUwODY2dsafagggdagDE3MjMxNzYxNTYuMTEyNw==", "msg": "操作成功", "code": 0 }

提取模式 - 获取账密

接口：/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}

提取模式 - 修改账密

接口：/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=NTBmM2UxMjRmYmM0M2ViNzJkN2E1NjZlMGUxNTM2ODY1N2E4ODYxYg==&n=123456abc&p=123456abc&ts=1609430400

{"success": true,"data": "","msg": "操作成功","code": 0}

提取模式 - 切换出口IP

港澳台地区需要先对账号进行实名，才可以使用

该板块介绍主动切换提取模式动态ip的出口ip，操作方法：拼接一串url链接，可在第三方软件上切换url来达到切换出口ip的目的

接口路径：/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

端口模式 - 释放动态IP池

接口：/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}

端口模式 - 批量释放动态IP池

接口：/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}

端口模式 - 修改ip切换周期

接口：/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}

设置独立账密

设置线路备注

批量设置线路备注

流量使用明细

接口： /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
t	int	流量类型[可选参数]	2=>动态住宅 3=>移动代理不传默认为2

结果数据

类型：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=NzhlY2E2ZjU1ZjgwZWQxNDYwMmRjY2RmODdkYzdiNWY0YmIzN2ExMw==&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}

流量使用详情导出

接口：/tdetailex

该接口返回当前用户的动态套餐余额信息

请求参数

参数名	类型	描述	示例
sdate	string	查询开始日期	2024-11-1
edate	string	查询结束日期	2024-11-11
gb	string	时间聚合类型， d=天，h=小时	d
gb2	string	详细信息聚合[可选参数] 可选 geo=>地区，mode=>使用模式，proxy=>线路id	geo,mode,proxy
subid	string	账号id，-1表示主账号+子账号，不传或0默认只展示主账号数据[可选参数]	-1
t	int	流量类型[可选参数]	2=>动态住宅 3=>移动代理不传默认为2

结果数据

该接口无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=NzIxZjFjZDM1YzAyYTAwOGI2ODFhZWZiYjE5YmE0YjYyMmRkMmFkYQ==&sdate=2024-11-1&edate=2024-11-11&gb=d&ts=1609430400

流量变更记录

接口：/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',不传默认全部类型[可选参数]
pt	int	流量类型[可选参数]	2=>动态住宅 3=>移动代理不传默认为2

结果数据

类型：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=ZDUwY2I3MDg4MjU5MDI5NzU2NTUwZGE1YWFkYmM0MDBhOTQ5MjBlOA==&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

接口：/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}

端口模式 - 用量查询

接口：/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}

流量套餐分发

接口：/checkt?to=目标用户ID&p=分发套餐&n=分发数量

该接口生成一张未处理的流量分发订单，并返回分发详细信息

流量分发订单不会产生费用，一旦支付，对应流量会从代理账户扣除，并增加到对应的子账户

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

请求参数

参数名	类型	描述	示例
to	int	目标用户ID	12345678 代理名下的账户ID
p	int	分发套餐	1：动态住宅 1GB 初级套餐 2：动态住宅 10GB 进阶套餐 3：动态住宅 100GB 高级套餐 5：动态住宅 1TB 专业套餐 6：动态住宅 5TB 企业套餐 100：动态住宅 100MB 测试套餐 3001：移动代理 1GB 初级套餐 3002：移动代理 10GB 进阶套餐 3003：移动代理 100GB 高级套餐 3005：移动代理 1TB 专业套餐 3006：移动代理 5TB 企业套餐
n	int	分发数量，p=1,n=5表示分发5个1G套餐，就是5G	1
toun	string	目标用户名（如果非代理名下用户需要验证）[可选参数]	hello
t	int	流量类型[可选参数]	2=>动态住宅 3=>移动代理不传默认为2

结果数据

类型：对象 (临时分发订单)

属性	类型	描述	示例
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
type	int	流量类型	2
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,"type":"2","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 代理名下的账户ID
n	int	分发流量，单位为MB （n=-1表示回收所有流量，仅回收可用）	777
toun	string	目标用户名（如果非代理名下用户需要验证）[可选参数]	hello
type	string	type=deliver，表示可以给子帐密任意分配流量 type=recycle，表示可以回收子账密流量	deliver
t	int	流量类型[可选参数]	2=>动态住宅 3=>移动代理不传默认为2

结果数据

类型：对象 (临时分发订单)

属性	类型	描述	示例
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=OWY0NTQxMzBiMDVjZmVkN2NhYWI4MjgxYjFhMzZjYzk3YjhiMWJjYg==&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}

kkoip

请求

API请求路径为： https://www.kkoip.com/clientapi/

所有请求采用 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}

修改鉴权账密

接口：/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=ZTVlYzk2OTNmMWE1OTg1ZGI3NGM4ZGI5ODA3MjY5ZmVkMDc1YzZmMg==&n=123456&p=ABCDEFGH&ts=1609430400

{"success":true,"data":"","msg":"操作成功","code":0}

添加白名单IP

接口：/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=Y2NiODQ1NDJiZjk3YjQ3YjJkYTkyZjYzMDNmZWE1ODkyNDBlN2VjNg==&ip=45.153.129.73&slock=1&ts=1609430400

{"success":true,"data":"","msg":"操作成功","code":0}

删除白名单IP

接口：/delwip? ip=ipv4地址

该接口可以把白名单列表中已添加的IP移除

请求参数

参数名	类型	描述	示例
ip	string	IPV4	45.153.129.73

结果数据

类型：string

描述：无

PHP示例: '/delwip?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'ip=45.153.129.73&ts=1609430400', '1234567ABCDEFG', false)).'&ip=45.153.129.73&ts=1609430400'

示例结果: /delwip?accessid=1&signature=Y2NiODQ1NDJiZjk3YjQ3YjJkYTkyZjYzMDNmZWE1ODkyNDBlN2VjNg==&ip=45.153.129.73&ts=1609430400

{"success":true,"data":"","msg":"操作成功","code":0}

获取白名单IP验证链接

接口：/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 }

白名单模式-提取线路

接口：/wpickip? g=动态地区id&n=提取数量

该接口会返回提取代理线路，用户需要已拥有已验证的白名单IP，才可获得数据

请求参数：

参数名	类型	描述	示例
g	int	动态地区id	433
n	int	提取数量,1-100，默认10	2

结果数据

类型：对象

属性	类型	描述	示例
data	string[]	线路列表	["112.118.111.111:7244", “192.168.3.1:7342”]

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=ODJjMzRkYjQzNDYzOTk2N2ViOGRlZGY4NmY3MTZhZGFlNjYzNjJiNA==&g=433&n=2&ts=1609430400

{ "success": true,"data": ["112.118.111.111:7244",“192.168.3.1:7342”],"msg": "操作成功","code": 0 }

生成流量分配订单

接口：/checkt?to=目标用户ID&n=1

该接口生成分配流量订单，并返回验证数据
如果输入用户ID非代理账户下的子账户，则需要添加toun参数输入目标用户名

请求参数

参数名	类型	描述	示例
to	string	目标用户ID	2 账户ID
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=MWQxMmVjMDMxZTk4ZjhiMTdmMjkxMDZkN2FlOTZjNGI0YzhmMTQzYQ==&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=Y2MxOWUwOTc0OWIzNmViMThjOGMxNTE2MDUzN2EzNzlhODI1OTQzOA==&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=ZDk4YmRiYzllYjQzNzhkNjIwMDg1YTQzYzM2NzcwZTQzODQ4ZTNkZQ==&ts=1609430400

{"success": true,"data": {"balance": 23155,"today_use": 44,"month_use": 190 },"msg": "操作成功", "code": 0}

流量使用明细

接口：/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=NzhlY2E2ZjU1ZjgwZWQxNDYwMmRjY2RmODdkYzdiNWY0YmIzN2ExMw==&sdate=2023-07-10&edate=2023-07-10&gb=d&ts=1609430400

流量变更记录

接口：/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',不传默认全部类型[可选参数]
subid	int	账号id，-1表示主账号+子账号，不传或0默认只展示主账号数据[可选参数]	-1

结果数据

类型：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=ZDUwY2I3MDg4MjU5MDI5NzU2NTUwZGE1YWFkYmM0MDBhOTQ5MjBlOA==&sdate=2024-07-01&edate=2024-07-12&ts=1609430400

动态提取模式切换出口IP

接口：/chgsessionip?uid=用户ID&token=开发者token&geo=国家ISO码

港澳台地区需要先对账号进行实名，才可以使用

该板块介绍主动切换提取模式动态ip的出口ip，操作方法：拼接一串url链接，可在第三方软件上切换url来达到切换出口ip的目的

提取参数详细说明

参数名	类型	描述	示例
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

子账号列表

接口：/subaccounts

该接口可以获取当前账号的子账号列表

请求参数

参数名	类型	描述	示例
is_kkoip	int	[可选参数]	0 或者不传, 返回全部用户; 1:是 kkoip 用户; 2:不是 kkoip 用户
page	int	页码[可选参数]	1
psize	int	单页数据条数[可选参数]	10

结果数据

类型：对象

属性	类型	描述	示例
page	int	页码	1
page_size	int	单页数据条数	10
total	int	总数据量	1
total_page	int	总分页数	1
list	object []	对象数组	[{对象数组},{对象数组}...]
uid	int	用户id	1234567
name	string	用户名	test0108
authname	string	安全策略默认账号	1dfd7584
authpwd	string	安全策略默认密码	2dfq7584
gateway	object []	可用网关:端口	["gate-hk.kkoip.com:14235","gate-us.kkoip.com:14235"]
token	string	开发者Token	1234567ABCDEFG
status	int	账号状态	1:有效， 2:已删除， 3:已失效（token刷新）， -2:禁用
is_kkoip	number	是否是kkoip用户	1:是 kkoip 用户 2:不是 kkoip 用户
traffic_left	int	流量余额（单位 Mb）	101623
remark	string	备注	111
add_time	number	账号创建时间	1748952407

PHP示例: '/subaccounts?accessid=1&signature='.base64_encode(hash_hmac("sha1", 'is_kkoip=1&page=1&psize=10&ts=1609430400', '1234567ABCDEFG', false)).'&is_kkoip=1&page=1&psize=10&ts=1609430400'

示例结果: /subaccounts?accessid=1&signature=MTI5YzA0ZDQyMDEyNGRiMzlmNGZiNDI3NjcyM2I2NWFjZjNmNmQ3YQ==&is_kkoip=1&page=1&psize=10&ts=1609430400

{"success":true,"data":{"page":1,"page_size":10,"total":1,"total_page":1,"list":[{"uid":5483598,"authname":"1dfd7584","authpwd":"2dfq7584","gateway":["gate-hk.kkoip.com:14235","gate-us.kkoip.com:14235"],"name":"test0108","token":"1234567ABCDEFG","status":1,"is_kkoip":1,"traffic_left":101623,"remark":"111","add_time":1767009922}]},"msg":"操作成功","code":0}

API版本更新

5、新增结果码80008

API调用说明 v2023.12.01

请求

签名

响应

结果码

kookeey-全局

余额

订单列表

订单信息

获取安全策略配置

设置安全策略

修改线路账密

添加白名单

移除白名单

添加PAC黑名单

移除PAC黑名单

获取PAC黑名单列表

子账号列表

创建子账户

删除子账号绑定关系

kookeey-静态

地区查询

价格查询

当前可用的代理类型ID

当前可用加速入口城市sp

新购

支付

续订

批量续订

修改自动续费

线路列表

线路信息

获取IP

恢复/停用

批量恢复/停用

设置独立账密

设置线路备注

批量设置线路备注

批量修改线路的带宽规格(预检查)

kookeey-动态

地区查询

价格查询

当前可用的代理类型ID

支付

动态城市查询

动态套餐余量

提取动态IP（账密）

提取动态IP（白名单）

提取移动代理IP

提取模式 - 添加白名单IP

提取模式 - 删除白名单IP

提取模式 - 白名单IP备注

提取模式-白名单IP列表

提取模式 - 获取白名单IP验证链接

提取模式 - 获取账密

提取模式 - 修改账密

提取模式 - 切换出口IP

端口模式 - 释放动态IP池

端口模式 - 批量释放动态IP池

端口模式 - 修改ip切换周期

设置独立账密

设置线路备注

批量设置线路备注

流量使用明细

流量使用详情导出

流量变更记录

端口模式 - 批量切换动态IP

端口模式 - 用量查询

流量套餐分发

自定义流量分发

kkoip

请求

获取鉴权账密

修改鉴权账密

添加白名单IP

删除白名单IP

获取白名单IP验证链接

白名单模式-提取线路

生成流量分配订单

支付流量分配订单

API调用说明 _v2023.12.01