硬件设备 /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", } ```