KDays API文档中心

请求约定

请求时的必要参数

Http Headers 需要提交的参数

参数名类型说明
X-API-KEYstring应用的API KEY
X-SIGNstring签名,具体签名见后面的签名方式
X-SIGN-TIMEstring当前客户端时间戳
X-TOKENstring用户登录后获取的TOKEN,没有可不传递

签名方式

签名 = sha1(请求体内容 + 应用的API Secret + 时间戳)

function sign(string $jsonBody) {
    $sigTime = time();
    $appSecret = "你的API Secret";
    return sha1($jsonBody . $appSecret . $sigTime);
}

返回约定

除去服务器意外场景,API只要请求成功,就会按http code 200返回,请根据返回中的code判断结果:

{
    "code": "返回码 0=成功 其他代表失败或意外情况",
    "msg": "提示信息",
    "data": "返回数据"
}

统一Code

下面code为用于标识常见的错误场景用于前期判断(如未登录):

Code原因
0成功
-100没有登录
-1000应用错误
-1001签名错误
-1002X-SIGN-TIME差异过大

On this page