群晖NAS可以发送邮件通知和短信通知,用于系统消息发送和系统出现故障时发送通知等用途。DSM系统提供了几个默认的短信服务商,都是大家没见过的,使用体验也不好。不过DSM系统可以新增短信服务商,这样就有的玩了。
利用DSM系统的自定义短信服务功能,我们可以把通知消息发送到钉钉群。实际上就是发送一个GET/POST请求到指定的服务器。默认直接发送到钉钉的消息是无法被接收的,因为需要有对应的参数、正确的消息签名和正确的消息格式,钉钉才能处理消息并发送到钉钉群里。
作者自建了一个服务接口,可以将收到的消息直接转发到对应的钉钉群,下边是使用方法。
1、准备工作
创建钉钉群,并加入自定义群机器人。[钉钉群消息机器人Webhook接口使用方法]
2、新建短信服务提供商
3、填写名称和网址
名称:任意字符
网址:
https://api.xinac.net/dingtalk?token=<access_token>&text=hello world&desp=text&number=0&keyword=<keyword>
方法:GET/POST
4、HTTP请求标题
此处可填写token
和secret
的值。在此设置后,url中不需要再次设置相应参数。
此处可不填写,需要将所有参数放到url中。
5、网址参数映射类型
下拉可以选择参数类型,发件人、短信内容、电话号码是必须要选的。
短信内容必须是 text=hello world
,其中hello world
是DSM系统要识别的内容,text
为api接口要接收的内容,后续收到消息时,dsm系统会将hello world
替换为对应的消息内容发送至api接口。
6、测试短信发送
点击应用保存,回到短信设置界面。发件人和主要电话号码必须填写。
点击应用,然后点击寄送测试短信按钮,正常情况下可收到钉钉群的消息。
7、api接口参数说明
接口网址:https://api.xinac.net/dingtalk
token:<access_token>,钉钉自定义机器人的access_token,必填
text:消息内容字符串,必填,DSM系统中固定为 hello world
keyword:钉钉消息关键字,与 secret 选填一个
secret:钉钉消息签名密钥,与 keyword 选填一个
最终格式为:
https://api.xinac.net/dingtalk?token=<access_token>&text=<text>&keyword=<keyword>
或:
https://api.xinac.net/dingtalk?token=<access_token>&text=<text>&secret=<secret>
用于dsm系统短信发送的网址示例:
https://api.xinac.net/dingtalk?token=<access_token>&text=hello world&desp=text&number=0&keyword=<keyword>
或:
https://api.xinac.net/dingtalk?token=<access_token>&text=hello world&desp=text&number=0&secret=<secret>
GitHub:xinac721/api_dingtalk
使用说明:https://api.xinac.net/dingtalk
- v1.1
1. 支持在 header 头中传递 token 和 secret 参数
2. 增加接口首页 html 页面
3. 支持发送 GET 和 POST 请求
- v1.2
1. 支持发送固定IP消息,需在钉钉机器人中设置固定IP(`固定IP可通过 nslookup api.xinac.net 命令查询`)
2. 支持直接向API发送钉钉 text 格式的消息体,可用于BT面板等消息通知

2022-01-13 11:48 2F
好用,666
2021-07-23 17:51 1F
你好,我用的办法已经成功了,但是想问一下 我如何能搭建你这样的接口接口网址:https://api.xinac.net/dingtalk
怕你说明时候停止服务了