微设备平台说明书
微设备使用说明书
开放 API 接口文档
模板变量的使用
本文档使用 MrDoc 发布
-
+
首页
模板变量的使用
# 模板变量使用文档 ## 概述 本文档描述了微设备支持的模板变量,这些变量可以在通道模板中使用,用于动态替换为实际的消息数据或设备信息。 ## 变量分类 ### 1. 短信相关变量 当消息类型为 `sms` 时可用: | 变量名 | 说明 | 示例值 | |--------|------|--------| | `{{短信内容}}` | 短信的具体内容 | "您的验证码是 123456" | | `{{短信号码}}` | 发送短信的号码 | "10086" | | `{{短信时间}}` | 接收短信的时间 | "2026-01-28 14:30:00" | ### 2. 来电相关变量 当消息类型为 `call` 时可用: | 变量名 | 说明 | 示例值 | |--------|------|--------| | `{{来电类型}}` | 来电类型,"来电"或"未接来电" | "未接来电" | | `{{来电号码}}` | 来电号码 | "13800138000" | | `{{来电时间}}` | 来电时间 | "2026-01-28 15:45:00" | ### 3. 开机相关变量 当消息类型为 `boot` 时可用: | 变量名 | 说明 | 示例值 | |--------|------|--------| | `{{启动时间}}` | 设备启动时间 | "2026-01-28 08:00:00" | ### 4. 通用变量 适用于所有消息类型: | 变量名 | 说明 | 示例值 | |--------|------|--------| | `{{时间}}` | 消息发生的时间 | "2026-01-28 14:30:00" | | `{{时间戳}}` | 消息发生的时间戳 | "1738125000" | | `{{事件类型}}` | 消息类型,如 "sms"、"call"、"boot" | "sms" | ### 5. 选项变量 由调用时传入的 `options` 参数提供: | 变量名 | 说明 | 示例值 | |--------|------|--------| | `{{标题}}` | 自定义标题 | "重要通知" | | `{{内容}}` | 自定义内容 | "这是一条测试消息" | ### 6. 设备信息变量 基于设备的实际信息: | 变量名 | 说明 | 示例值 | |--------|------|--------| | `{{设备名称}}` | 设备的自定义名称 | "我的 iPhone" | | `{{设备型号}}` | 设备的型号 | "iPhone 12" | | `{{imei}}` | 设备的 IMEI 号 | "123456789012345" | | `{{设备号码}}` | 设备的手机号码 | "138****8888" | | `{{iccid}}` | SIM 卡的 ICCID | "89860112345678901234" | | `{{运营商}}` | 移动网络运营商 | "中国移动" | | `{{固件版本}}` | 设备固件版本 | "1.0.0" | | `{{开机时长}}` | 设备已开机的时间 | "2小时30分钟" | | `{{纬度}}` | 设备当前位置的纬度 | "39.9042" | | `{{经度}}` | 设备当前位置的经度 | "116.4074" | | `{{地图链接}}` | 设备当前位置的地图链接 | "https://maps.google.com/?q=39.9042,116.4074" | | `{{信号强度}}` | 设备当前的信号强度 | "-75 dBm" | ## 使用示例 ### 短信通知模板示例 ``` 收到新短信 来自:{{短信号码}} 内容:{{短信内容}} 时间:{{短信时间}} 设备:{{设备名称}} ``` ### 来电通知模板示例 ``` {{来电类型}}提醒 号码:{{来电号码}} 时间:{{来电时间}} 设备:{{设备名称}} 信号:{{信号强度}} ``` ### 开机通知模板示例 ``` 设备已开机 时间:{{启动时间}} 设备:{{设备名称}} 位置:{{纬度}}, {{经度}} 地图:{{地图链接}} ``` ## 注意事项 1. 变量名区分大小写,请严格按照文档中的格式使用 2. 变量使用双大括号 `{{}}` 包围 3. 对于不存在的变量,系统会将其替换为空字符串 4. 变量中的特殊字符(如 `%`)会被自动转义,无需手动处理 5. 设备信息变量依赖于设备的实际状态,某些变量可能在特定情况下为空
root
2026年1月28日 10:28
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
分享
链接
类型
密码
更新密码