V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
star7th
V2EX  ›  分享创造

showdoc 推送服务

  •  1
     
  •   star7th · 2022-03-04 09:56:10 +08:00 · 3647 次点击
    这是一个创建于 1021 天前的主题,其中的信息可能已经有所发展或是发生改变。

    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 错误信息
    29 条回复    2023-12-17 18:43:01 +08:00
    advancejar
        1
    advancejar  
       2022-03-04 09:59:53 +08:00
    类似工具已经有几个行业标杆了,还是需要时间的积累,比如各种告警脚本里有他的身影了才会有更多人用
    star7th
        2
    star7th  
    OP
       2022-03-04 10:03:58 +08:00
    @advancejar 我是研究过的,觉得还是有必要再做一个。因为类似工具的用户体验和 UI 都不算好,而且也有各种发送限制。showdoc https://www.showdoc.com.cn/ 主要群体是开发者,我可以把这个推送服务作为底层基础设施,链接起一些服务,比如后续做变更提醒甚至自己做监控服务都行。预留空间方便以后做 showdoc 的产品生态。
    zhcode
        3
    zhcode  
       2022-03-04 10:09:59 +08:00
    试了下,带 emoji 的消息发不出去 😉😊😎😎
    star7th
        4
    star7th  
    OP
       2022-03-04 10:16:38 +08:00
    @zhcode 已经处理好了。刚才是数据库编码没选好。
    zhcode
        5
    zhcode  
       2022-03-04 10:27:47 +08:00
    @star7th 可以了 消息内容会考虑支持 markdown 吗
    star7th
        6
    star7th  
    OP
       2022-03-04 10:30:34 +08:00
    @zhcode 其实支持 markdown 从技术上说很简单,我当初也预留了代码。只是再想要不要用。因为支持 markdown 的话表示也支持了 html 代码。这样我要额外增加一些安全过滤,以及调整 UI 以防止样式走样。我再调试下吧
    star7th
        7
    star7th  
    OP
       2022-03-04 11:01:48 +08:00
    @zhcode 已经开启对 markdown 的支持了 。由于页面缓存,你未必马上能看到最新效果。你再点击微信消息卡片进入网页后,再点击右上角,刷新。这样强制刷新当前页面才能更新缓存。这是微信自身的机制。
    mydingyan
        8
    mydingyan  
       2022-03-04 11:13:44 +08:00
    在用 showdoc 写技术文档,真好用~
    部分功能还需要优化呀
    star7th
        9
    star7th  
    OP
       2022-03-04 11:27:32 +08:00
    @mydingyan 比如哪些功能需要优化呢
    zagfai
        10
    zagfai  
       2022-03-04 11:37:36 +08:00
    收费么?怎么确保收到,有没有附带短信电话通知服务。
    dong706
        11
    dong706  
       2022-03-04 11:40:51 +08:00
    @advancejar 问下 除了 wxpusher 之外还有啥?
    ersic
        12
    ersic  
       2022-03-04 11:42:43 +08:00
    现在推送只显示标题,内容点开才能看,是不是截取一部分放到外面更好呢。
    zhcode
        13
    zhcode  
       2022-03-04 11:54:35 +08:00
    @star7th 好迅速啊😂 showdoc 我们公司一直在用 很好用啊 支持!!!
    star7th
        14
    star7th  
    OP
       2022-03-04 12:14:02 +08:00
    @zagfai 不收费;因为模板消息本身是免费的,所以我也没有成本压力,就没必要收费了。但是,如果接入电话和短信,那我就要付出成本了,所以就不提供短信电话了。
    star7th
        15
    star7th  
    OP
       2022-03-04 12:14:54 +08:00
    @dong706 还有 server 酱吧。不过我还是坚持认为我的推送服务 UI 更好看,哈哈
    star7th
        16
    star7th  
    OP
       2022-03-04 12:16:20 +08:00   ❤️ 1
    @ersic 这是出于风险的考虑。内容直接放到微信消息内部的话,以后容易被滥用举报。现在用网页展示更多内容,被举报也只是某个网页整改,风险可控
    scarleast
        17
    scarleast  
       2022-03-04 12:29:41 +08:00
    推送内容,参数能用 json ,post 放 body 里就好了
    star7th
        18
    star7th  
    OP
       2022-03-04 12:41:15 +08:00
    @scarleast 现状就支持的。
    你可以传输
    {
    "title":"标题",
    "content":"内容"
    }

    只要请求的 Content-Type 标头正确设置为 application/json 即可
    scarleast
        19
    scarleast  
       2022-03-04 13:30:10 +08:00
    @star7th 测了下好使,没乱七八糟的广告好评。最后要是像 server 酱最近搞那个 pushdeer ,不依赖微信,用轻 APP 或者快应用推就太完美了。
    star7th
        20
    star7th  
    OP
       2022-03-04 13:41:35 +08:00
    @scarleast 这个推送服务是主打用户体验,所以 UI 简洁 /使用也简单。目前鉴于微信的普及程度很高,所以暂时就用它,用户基本扫码就能用。模板消息之前说可能下线,但是一年了都没消息,我估计官方不敢轻易下线了的,因为使用太普遍了。
    轻应用或者快应用都需要用户额外做点什么配置,目前普及还不够。等以后发展再看看有没有必要吧。
    bequt
        21
    bequt  
       2022-03-04 14:40:42 +08:00 via iPhone
    一分钟内能推送多少条呢
    star7th
        22
    star7th  
    OP
       2022-03-04 14:44:44 +08:00
    @bequt 一分钟内能推送 10 条。只对发送频率限制,发送的总数量不限制。正常使用的话,一分钟内 10 条就很够用了。
    billzbc
        23
    billzbc  
       2022-03-04 16:59:10 +08:00
    刚体验了,简洁好用!要有推送的历史记录就更好了
    star7th
        24
    star7th  
    OP
       2022-03-04 17:37:02 +08:00
    @billzbc 后面考虑加上
    gongquanlin
        25
    gongquanlin  
       2022-03-08 10:26:37 +08:00
    卡片里的“通知内容”能否自定义,现在是“点击卡片以查看更多内容”
    star7th
        26
    star7th  
    OP
       2022-03-08 10:30:08 +08:00
    @gongquanlin 不开放自定义内容字段。因为可能会被滥用举报封号。现在把主要内容放在网页上,举报也能快速整顿网页。而发在微信消息内部是很难控制的
    bequt
        27
    bequt  
       2022-04-29 08:28:12 +08:00
    @star7th 是否可以取消必填 content
    star7th
        28
    star7th  
    OP
       2022-04-29 11:13:48 +08:00
    @bequt 这就没必要了吧,你实在不需要的话传个空格都行
    laminux29
        29
    laminux29  
       2023-12-17 18:43:01 +08:00
    @advancejar

    请问有哪些行业标杆?谢谢。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1440 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 31ms · UTC 17:18 · PVG 01:18 · LAX 09:18 · JFK 12:18
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.