业务数据开发

接口原型

请求方法 POST
请求地址 http://http.ctwing.cn:8991/topic
https://http.ctwing.cn:8992/topic
传输协议 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平台设备信息管理中获取。
accessToken 必选 String Body 设备鉴权参数。登陆鉴权报文中返回。
topic 必选 String Body 上报主题。非透传产品,为服务定义生成的服务标识;透传产品可任意填写。
payload 必选 String Body 业务数据。仅支持JSON格式。非透传产品需根据服务定义填写。

响应参数

参数 描述
code 业务返回码,0为成功
message 鉴权结果

请求示例

Method: POST

request:

http://http.ctwing.cn:8991/topic

Header:

timestamp: 1551753880000

signKey: ***

signature: *******

Content-Type: application/json

Body:

{

"productId": 10000000,

"deviceId": "100000001234",

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

"topic":"uptest"

"payload":{"up":1, "test":1}

}

响应示例

response:

Status Code: 200 OK

Content-Type: application/json

Body:

{

"code": 0,

"message": "SUCCESSFUL"

}

返回码

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)

业务返回码 描述 说明
0 SUCCESSFUL 数据发送成功
10000 common error 未知错误
10001 Product is not exist. 产品不存在。不存在此productId对应的产品。
10003 Parameter error 参数验证失败。缺少参数或参数格式错误。
20000 Signature error 签名错误
20002 accessToken error accessToken错误
20003 accessToken is null accessToken未携带
20004 accessToken is expired or deviceId error accessToken超期或设备Id错误。需检查设备Id是否正确,或重新鉴权接入
30001 Publish message error 数据上报失败

搜索结果 ""

    没有搜索结果 ""