API调用说明 v2023.12.01
请求
API请求路径为: https://kookeey.com/
所有请求采用 HTTP GET 方式
请求固定包含accessid
,signature
和ts
3个参数
单账户的请求频率限制为 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 | 成功 |
10006 | 参数错误 |
10015 | 签名超时 |
20001 | 数据状态错误 |
20002 | 数据不存在 |
20003 | 数据已经存在 |
20004 | 用户名已经存在 |
40001 | 身份验证错误 |
40005 | 余额不足 |
40008 | 至少需要开启一种安全策略 |
40009 | 无权执行该操作 |
40010 | 账户密码认证已被关闭 |
40011 | 存在设置单独的用户名密码的未过期线路 |
40012 | 动态流量余额不足,请购买动态代理流量包 |
40013 | 超过可开启独立线路上限 |
40014 | 产品尚未开放自主购买 |
40015 | 非活动用户,不可领取 |
40016 | 目标用户不在代理名下 |
40017 | 超过可批量处理数据上限 |
60001 | 请求过于频繁 |
80003 | 库存不足 |
80004 | 订单无效 |
80005 | 支付失败 |
80006 | 端口正在配置中 |
80007 | 订单正在支付中,请勿重复提交 |
80008 | 静态端口不允许手动释放 |