# hardwareDevice.getSnTicket
本接口应在服务器端调用,详细说明参见服务端API。
获取设备票据,5 分钟内有效。
# 请求地址
POST https://api.weixin.qq.com/wxa/getsnticket?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
access_token / cloudbase_access_token | string | 是 | 接口调用凭证 | |
sn | string | 是 | 设备唯一序列号。由厂商分配,长度不能超过128字节。字符只接受数字,大小写字母,下划线(_)和连字符(-)。 | |
model_id | string | 是 | 设备型号 id ,通过注册设备获得。 |
# 返回值
# Object
返回的 JSON 数据包
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
sn_ticket | string | 设备票据,5分钟内有效。 |
errcode 的合法值
值 | 说明 | 最低版本 |
---|---|---|
-1 | 系统失败 | |
9800001 | sn 长度超出限制 | |
9800002 | sn 含有非法字符 | |
9800003 | model_id 错误 |
# 请求示例
{
"model_id": "XXXXX",
"sn": "XXXXX",
}