设备与模板

胸牌设备相关开放接口。带 body 的请求（验证、绑定、按模板下发）使用与推送相同的 AES-256-GCM 包装（见 安全规范），并带 Authorization: Bearer <accessToken>。GET 接口无 body，同样带该请求头。

绑定与按模板下发成功时 code 为 200，与推送 ACK / Token / 查询 / 回调的 2000 不同。

本目录

页面	路径
验证设备	POST /openapi/v1/devices/verify
设备状态	GET /openapi/v1/devices/{deviceSn}/info
录音文件	GET /openapi/v1/devices/{deviceSn}/files
绑定状态	POST /openapi/v1/devices/binding-status
模板列表	GET /openapi/v1/devices/templates
按模板下发	PUT /openapi/v1/devices/{deviceSn}/template

错误码

code	HTTP	含义	典型场景
DEVICE_NOT_FOUND	404	设备不存在或不属于本租户	deviceSn 无效
DEVICE_DISABLED	403	设备已禁用	验证设备时设备已禁用
TEMPLATE_NOT_FOUND	404	模板不存在或本企业不可用	templateId 不在模板列表中
INVALID_REQUEST	400	参数不合法	deviceType、绑定或模板字段不合法

通用错误码见 开放接口。