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 | 成功 |
| 10006 | 参数错误 |
| 10015 | 签名超时 |
| 10059 | 签名错误或超时 |
| 10061 | 数量范围为1-99 |
| 20001 | 数据状态错误 |
| 20002 | 数据不存在 |
| 20003 | 数据已经存在 |
| 20004 | 用户名已经存在 |
| 40001 | 身份验证错误 |
| 40005 | 余额不足 |
| 40008 | 至少需要开启一种安全策略 |
| 40009 | 无权执行该操作 |
| 40010 | 账户密码认证已被关闭 |
| 40011 | 存在设置单独的用户名密码的未过期线路 |
| 40012 | 动态流量余额不足，请购买动态代理流量包 |
| 40013 | 超过可开启独立线路上限 |
| 40014 | 产品尚未开放自主购买 |
| 40015 | 非活动用户，不可领取 |
| 40016 | 目标用户不在代理名下 |
| 40017 | 超过可批量处理数据上限 |
| 60001 | 请求过于频繁 |
| 80003 | 库存不足 |
| 80004 | 订单无效 |
| 80005 | 支付失败 |
| 80006 | 端口正在配置中 |
| 80007 | 订单正在支付中，请勿重复提交 |
| 80008 | 静态端口不允许手动释放 |
