「信达」更新啦——支持上行下行的双向消息推送服务

快速开始

注册及关注微信服务号

首先,你需要注册一个账号,从而获取 secretkey。这是调用信达 API 的鉴权方式。

https://sender.xzhsh.ch/signup

关注公众号并取得 Secretkey。

接收通知

调用下面的接口即可通过公众号发送消息。接口参数和 Server 酱一样。

https://sender.xzhsh.ch/api/v1/notification?secretkey=<your_sk>&title=<title>&desc=<desc>

desc 参数表示正文。支持使用 markdown 语法。在公众号消息卡片点击,能跳转到完整的消息内容页面。

截止到目前,这是一个和 Server 酱一样的消息推送服务。

发送「信令」

在公众号消息框发送的消息(信令)会被信达服务器加入一个队列。等待 Agent(接收消息的一侧)拉取。

除了使用公众号发送信令,也可以使用 API。

[POST]https://sender.xzhsh.ch/api/v1/signaling?secretkey=<your_sk>&signaling=<signaling>

API 与公众号发送的效果相同。

在 Agent 一侧调用这个 API 可以获取现有的信令。每隔一分钟轮询这个接口可以实时接收信令。

[GET]https://sender.xzhsh.ch/api/v1/signaling?secretkey=<your_sk>
{
    "code": 0,
    "msg": "ok",
    "res": [
        {
            "id": 4,
            "agent": "",
            "signaling": "hello",
            "status": "new",
            "created_at": 1620557824
        },
        {
            "id": 5,
            "agent": "",
            "signaling": "hi",
            "status": "new",
            "created_at": 1620560592
        }
    ]
}

Webhook

除了使用 API 轮询信令,还可以设置一个 Webhook 主动接收信令。

发送信令后 webhook 会收到这样的一个 POST 请求。

{
    "id": 5,
    "agent": "",
    "signaling": "hi",
    "status": "new",
    "created_at": 1620560592
}

接收结果

信令通常代表的是需要执行的任务。

使用结果提交 API 向信达报告任务执行的结果,同时公众号也会推送结果通知。

[POST]https://sender.xzhsh.ch/api/v1/result?secretkey=<your_sk>&signaling=<signaling_id>

MultipartForm POST Body: result=<result>

TODO

计划开发一个 cli 工具,用于向公众号推送通知,以及将信令拉取转换为 Shell。

  • 互联网

    互联网(Internet),又称网际网络,或音译因特网、英特网。互联网始于 1969 年美国的阿帕网,是网络与网络之间所串连成的庞大网络,这些网络以一组通用的协议相连,形成逻辑上的单一巨大国际网络。

    92 引用 • 329 回帖
  • 创造

    你创造的作品可能会帮助到很多人,如果是开源项目的话就更赞了!

    132 引用 • 810 回帖
  • golang

    Go 语言是 Google 推出的一种全新的编程语言,可以在不损失应用程序性能的情况下降低代码的复杂性。谷歌首席软件工程师罗布派克(Rob Pike)说:我们之所以开发 Go,是因为过去 10 多年间软件开发的难度令人沮丧。Go 是谷歌 2009 发布的第二款编程语言。

    461 引用 • 1358 回帖 • 619 关注
  • React

    React 是 Facebook 开源的一个用于构建 UI 的 JavaScript 库。

    171 引用 • 267 回帖 • 552 关注
2 操作
zhshch 在 2021-05-10 15:22:48 更新了该帖
zhshch 在 2021-05-10 15:13:16 更新了该帖

广告 我要投放

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...
  • ldd

    牛逼嗷