API Reference
Pingo 接口
最快捷的企微、微信、QQ 等平台推送方案,开通即用。免注册、内存转发,当前无人在线的消息会被直接丢弃。
1. 单渠道
POST https://pingo.minapp.xin/:token/push
Body: { content: string, type?: string, meta?: object }
说明:向 token 关联的渠道推送消息;无人监听则丢弃。
GET https://pingo.minapp.xin/:token/listen
SSE 监听该 token 的实时消息。
2. 频道
POST https://pingo.minapp.xin/channel/:id/join
Body: { token: string, password?: string }
说明:将 token 绑定到频道,可选加入密码。
POST https://pingo.minapp.xin/channel/:id/leave
Body: { token: string }
说明:解绑频道成员。
POST https://pingo.minapp.xin/channel/:id/settings
Body: { joinPassword?: string|null, pushPassword?: string|null }
说明:设置/清除频道的加入或推送密码。
POST https://pingo.minapp.xin/channel/:id/push
Body: { content: string, type?: string, meta?: object, password?: string }
说明:广播给频道成员的 token 监听者(/:token/listen),当前无监听则丢弃。
3. 示例
推送
curl -X POST https://pingo.minapp.xin/<token>/push -H 'Content-Type: application/json' -d '{"content":"Build done"}' 监听
curl https://pingo.minapp.xin/<token>/listen
频道推送
curl -X POST https://pingo.minapp.xin/channel/demo/push -H 'Content-Type: application/json' -d '{"content":"Hello channel"}' 说明
- 消息不落盘,只面向当前在线监听者。
- 频道密码可选;丢失 token 视为权限泄露,建议定期轮换。
- 建议网关层增加限流与最大 body 限制,保证稳定性。