按模板下发

按 templateId 渲染胸牌并下发到该设备。displayVersion 从 1 起按设备单调递增；旧版本幂等成功，不重复下发。

项	说明
方向	你 → 平台
方法	`PUT`
路径	`/openapi/v1/devices/{deviceSn}/template`
Header	`Authorization: Bearer <accessToken>`、`Content-Type: application/json`

请求

请求体为密文外壳。解密后明文：

json

{
  "displayVersion": 1,
  "templateId": 1,
  "color": "RED",
  "name": "张三",
  "department": "销售部",
  "title": "客户经理",
  "no": "A001",
  "logoText": "公司名"
}

参数名	类型	必传	描述
displayVersion	int	是	从 1 起按设备单调递增
templateId	int	是	须为模板列表返回的 ID
color	string	否	`YELLOW` / `RED` / `WHITE` / `BLACK`，默认 `YELLOW`
name	string	是	姓名
department	string	否	部门
title	string	否	职位
no	string	否	工号
logoText	string	否	Logo 文字

模板上没有的槽位忽略对应字段。

响应

json

{ "code": 200, "message": "ACCEPTED", "requestId": "<uuid>" }

参数名	类型	必传	描述
code	int	是	`200` 表示已接受
message	string	否	如 `ACCEPTED`
requestId	string	否	请求追踪 ID

按模板下发 ​

请求 ​

响应 ​

按模板下发

请求

响应