登陆鉴权

接口原型

请求方法 POST
请求地址 http://http.ctwing.cn:8991/auth
https://http.ctwing.cn:8992/auth
传输协议 HTTP(S)

请求头部

参数 必选/可选 类型 位置 描述
signKey 必选 String Header 签名秘钥,由设备生成,携带至平台
timestamp 必选 Int (long) Header 时间戳。(20分钟有效。前后相差不得超过10分钟)
signature 必选 String Header 签名。算法:sha256 (signKey+MasterKey+timestamp)。MasterKey为AEP平台上创建产品时生成,可在产品概况中查询。
Content-Type 必选 String Header application/json

请求参数

参数 必选/可选 类型 位置 描述
productId 必选 Int (long) Body 产品Id,AEP平台产品概况中获取。
deviceId 必选 String Body 设备Id,AEP平台设备信息管理中获取。
password 必选 String Body 设备特征串。AEP平台生成。可在设备信息管理-认证信息查询。
version 可选 String Body 版本号。

响应参数

参数 描述
code 业务返回码,0为成功
message 鉴权结果
accessToken 鉴权参数,访问AEP平台的凭证。每次上报数据时,都需要携带accessToken信息。如果accessToken失效,需要重新认证获取accessToken。accessToken的有限期为5分钟。

请求示例

Method: POST

request:

http://http.ctwing.cn:8991/auth

Header:

timestamp: 1551753880000

signKey: ***

signature: *******

Content-Type: application/json

Body:

{

"productId": 10000000,

"deviceId": "100000001234",

"password":"2uUCYgSB_wyvcgWwqMYyZ3wM2sbkTdTuoVXNTYJ2vss",

"version":"1.0"

}

响应示例

response:

Status Code: 200 OK

Content-Type: application/json

Body:

{

"code": 0,

"message": "SUCCESSFUL",

"accessToken":"*********************************"

}

返回码

http状态码(Status Code)

http状态码(Status Code) 描述 说明
200 OK 请求正常
400 Bad request 请求数据缺失或格式错误
401 Unauthorized 请求缺少权限
403 Forbidden 请求禁止
404 Not found 请求资源不存在
500 Internal Error 服务器异常
503 Service Unavailable 服务不可用
504 Async Service 异步通讯

业务返回码(code)

业务返回码(code) 描述 说明
0 SUCCESSFUL 登录成功
10000 common error 未知错误
10001 Product is not exist. 产品不存在。不存在此productId对应的产品。
10002 Device is not exist. 设备不存在。不存在此deviceId对应的设备。设备未注册、已删除或已注销。
10003 Parameter error 参数验证失败。缺少参数或参数格式错误
20000 signature error 签名错误
20001 Auth Failure 设备鉴权失败

搜索结果 ""

    没有搜索结果 ""