硬件设备 /getSnTicket

# hardwareDevice.getSnTicket

> 本接口应在服务器端调用,详细说明参见[服务端API](https://developers.weixin.qq.com/miniprogram/dev/framework/server-ability/backend-api.html)。

获取设备票据,5 分钟内有效。



### 请求地址

```text
POST https://api.weixin.qq.com/wxa/getsnticket?access_token=ACCESS_TOKEN
```

### 请求参数

| 属性                                  | 类型   | 默认值 | 必填 | 说明                                                         |
| :------------------------------------ | :----- | :----- | :--- | :----------------------------------------------------------- |
| access_token / cloudbase_access_token | string |        | 是   | [接口调用凭证](https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/access-token/auth.getAccessToken.html) |
| 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 错误   |          |

### 请求示例

```json
{
  "model_id": "XXXXX",
  "sn": "XXXXX",
}
```