showdoc 推送服务

[star7th]

showdoc 推送服务 是 showdoc 旗下的一个独立工具，可以从服务器推送消息到手机。编写简单的几行代码，可以实时推送消息到微信，可用于服务器告警、程序监控通知、打印程序日志、向手机同步消息等场景。

本工具优势：使用简单、开箱可用、长期维护、持续免费、编程可玩、不限制消息数量、不限制请求数

打开推送服务的首页 https://push.showdoc.com.cn (最好在电脑端访问。移动端访问不够友好) ,切换到右上角的“推送”导航菜单，可以看到你的专属推送地址。只要在服务器程序中调用此地址，传递消息参数，手机微信便可以收到消息。

下面是推送地址的参数说明。

请求 URL

[你的专属推送地址]

请求方式

GET 或者 POST

参数

参数名	必选	类型	说明
title	是	string	推送的消息标题
content	是	string	推送的消息内容

成功返回示例

{
  "error_code": 0,
  "error_message": "ok"
}

失败返回示例

{
  "error_code": 10103,
  "error_message": "url 或 token 不正确"
}

返回参数说明

参数名	类型	说明
error_code	int	错误码。为 0 时表示没有发生错误（即接口请求成功）。非 0 的时候表示有错误码
error_message	string	错误信息

[advancejar]

类似工具已经有几个行业标杆了，还是需要时间的积累，比如各种告警脚本里有他的身影了才会有更多人用

[star7th]

@advancejar 我是研究过的，觉得还是有必要再做一个。因为类似工具的用户体验和 UI 都不算好，而且也有各种发送限制。showdoc https://www.showdoc.com.cn/ 主要群体是开发者，我可以把这个推送服务作为底层基础设施，链接起一些服务，比如后续做变更提醒甚至自己做监控服务都行。预留空间方便以后做 showdoc 的产品生态。

[zhcode]

试了下，带 emoji 的消息发不出去 😉😊😎😎

[star7th]

@zhcode 已经处理好了。刚才是数据库编码没选好。

[zhcode]

@star7th 可以了 消息内容会考虑支持 markdown 吗

[star7th]

@zhcode 其实支持 markdown 从技术上说很简单，我当初也预留了代码。只是再想要不要用。因为支持 markdown 的话表示也支持了 html 代码。这样我要额外增加一些安全过滤，以及调整 UI 以防止样式走样。我再调试下吧

[star7th]

@zhcode 已经开启对 markdown 的支持了 。由于页面缓存，你未必马上能看到最新效果。你再点击微信消息卡片进入网页后，再点击右上角，刷新。这样强制刷新当前页面才能更新缓存。这是微信自身的机制。

[mydingyan]

在用 showdoc 写技术文档，真好用~
部分功能还需要优化呀

[star7th]

@mydingyan 比如哪些功能需要优化呢

[zagfai]

收费么？怎么确保收到，有没有附带短信电话通知服务。

[dong706]

@advancejar 问下 除了 wxpusher 之外还有啥？

[ersic]

现在推送只显示标题，内容点开才能看，是不是截取一部分放到外面更好呢。

[zhcode]

@star7th 好迅速啊😂 showdoc 我们公司一直在用 很好用啊 支持！！！

[star7th]

@zagfai 不收费；因为模板消息本身是免费的，所以我也没有成本压力，就没必要收费了。但是，如果接入电话和短信，那我就要付出成本了，所以就不提供短信电话了。

[star7th]

@dong706 还有 server 酱吧。不过我还是坚持认为我的推送服务 UI 更好看，哈哈

[star7th]

@ersic 这是出于风险的考虑。内容直接放到微信消息内部的话，以后容易被滥用举报。现在用网页展示更多内容，被举报也只是某个网页整改，风险可控

[scarleast]

推送内容，参数能用 json ，post 放 body 里就好了

[star7th]

@scarleast 现状就支持的。
你可以传输
{
"title":"标题",
"content":"内容"
}

只要请求的 Content-Type 标头正确设置为 application/json 即可

[scarleast]

@star7th 测了下好使，没乱七八糟的广告好评。最后要是像 server 酱最近搞那个 pushdeer ，不依赖微信，用轻 APP 或者快应用推就太完美了。

[star7th]

@scarleast 这个推送服务是主打用户体验，所以 UI 简洁 /使用也简单。目前鉴于微信的普及程度很高，所以暂时就用它，用户基本扫码就能用。模板消息之前说可能下线，但是一年了都没消息，我估计官方不敢轻易下线了的，因为使用太普遍了。
轻应用或者快应用都需要用户额外做点什么配置，目前普及还不够。等以后发展再看看有没有必要吧。

[bequt]

一分钟内能推送多少条呢

[star7th]

@bequt 一分钟内能推送 10 条。只对发送频率限制，发送的总数量不限制。正常使用的话，一分钟内 10 条就很够用了。

[billzbc]

刚体验了，简洁好用！要有推送的历史记录就更好了

[star7th]

@billzbc 后面考虑加上

[gongquanlin]

卡片里的“通知内容”能否自定义，现在是“点击卡片以查看更多内容”

[star7th]

@gongquanlin 不开放自定义内容字段。因为可能会被滥用举报封号。现在把主要内容放在网页上，举报也能快速整顿网页。而发在微信消息内部是很难控制的

[bequt]

@star7th 是否可以取消必填 content

[star7th]

@bequt 这就没必要了吧，你实在不需要的话传个空格都行

[laminux29]

@advancejar

请问有哪些行业标杆？谢谢。

[NianBroken]

新版加了光晕，能不能自定义去掉这个光晕呀，感觉之前那种简洁的样式更好看。

[star7th]

@NianBroken

审美的事情见仁见智。目前收到的反馈，大多数都是说新版更好看

[NianBroken]

@star7th #31 能加个开关吗？比如请求体里面带个参数就使用以前的样式