XuJoe Api Test(类似Server酱)

XuJoe Api Test 是一款面向开发者和自动化爱好者的轻量级消息推送工具，可以把它理解成自建版的 Server酱。部署在服务器上之后，只要通过一个简单的 GET 或 POST 请求，就能把标题和内容推送出去，手机端基本能做到 1 到 2 秒内收到通知。整个工具由后台服务和单页展示界面组成，数据存放在本地的 Sqlite 文件中，不依赖第三方云服务，适合个人或小团队折腾。

这个工具能做什么

1、 通过 GET 或 POST 请求把消息内容写入服务器上的 Sqlite 数据库，请求格式里包含 SendKey 和标题、正文三个关键参数

2、 自带一个单页的 HTML 展示界面，打开浏览器就能看到数据库里已推送的所有消息记录，方便回溯

3、 每个用户需要拿着自己生成的 SendKey 才能成功请求，这个 Key 支持自定义，建议设得复杂些以防别人乱刷

4、 典型玩法跟 Server酱类似：把它挂进自动化任务里当通知出口，比如配合安卓的 Tasker 转发短信、微信通知等

部署和启动步骤

- 下载压缩包后先解压到任意目录，直接双击运行 WindowsFormsApiTest.exe 就能起来，默认监听 9090 端口

- 想换端口的话，打开同目录下的 HttpConfig.json 文件，修改 Port 字段的值再重启程序即可

- 查询页面通过 http://IP:Port/ 访问，本机可以直接用 localhost 测试

- 发消息的 GET 格式为：http://IP:Port/Send?SendKey=生成的Key&tilte=标题&text=内容；POST 格式则把地址换成 /PostSend，参数相同

- 工具核心只做两件事：存标题、存内容，界面也以展示这两项为主，没有多余的花哨功能

常见问题排查

- 如果配置改乱了或者程序表现异常，直接重置配置文件然后重启软件一般就能恢复

- 更彻底的办法是删掉整个目录，重新解压一份初始包，注意这样做会清空已有的消息数据

- 本机能访问、但局域网或外网不行，优先检查系统防火墙是否放行了程序端口，或者尝试临时关闭防火墙做对比测试

- 端口被占用时也会导致启动失败，换一个高位端口如 9091 再试试

接口调用补充说明

1、 除了标准推送，接口本身也可以配合定时任务或脚本，实现简单的定时消息提醒

2、 由于请求方式是标准 HTTP，任何支持发请求的语言（Python、Shell、JavaScript 等）都能直接接入

3、 如果追求更高的安全性，可以在服务端层面再套一层访问控制，比如限制来源 IP，不过工具本身未内置这类功能