文档中心 > API类目 > 智能设备

qimen.alibaba.retail.device.message.report (设备消息上报)

在设备上报消息时，向ISV回告消息内容

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
deviceCode	String	必须	123456	TmallDeviceCode
deviceSn	String	必须	asdfasdfasdf	TmallDeviceSn
messageId	String	必须	123456	消息id
sourceMessageId	String	可选	12345	源消息id
code	Number	可选	200	状态码
data	Struct	必须		消息内容
└ message String 可选无法执行错误消息 └ cmd String 可选 external.battery.get 原始指令 └ response String 可选 {"hello":"world"} JSON对象字符串

响应参数

名称	类型	示例值	描述
code	String	CE000	代码
succ	Boolean	true	是否成功
msg	String	失败了	消息

请求示例

{"code":200,"data":{"response":"{\"hello\":\"world\"}","cmd":"external.battery.get","message":"无法执行"},"sourceMessageId":"12345","messageId":"123456","deviceCode":"123456","deviceSn":"asdfasdfasdf"}

响应示例

{
    "code":"CE000",
    "succ":true,
    "msg":"失败了"
}

验签示例

{"msg":"Illegal request","code":"sign-check-failure","succ":"不等于true"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

智能设备

qimen.alibaba.retail.device.message.report (设备消息上报)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ

用户导航

用户反馈

用户反馈

用户反馈