API调用说明 v2023.12.01
请求
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 |
接口响应状态，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 | 该优惠券已被其他订单锁定 |
