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/push?content=...
Query: { content: string, type?: string, meta?: string(JSON) }
说明:同上(便于脚本/浏览器快速调用)。
GET https://pingo.minapp.xin/:token/listen
SSE 监听该 token 的实时消息(会先收到 ready;首次连接会先下发一条 message(其中 type=welcome),重连不重复下发)。
2. 频道
POST https://pingo.minapp.xin/channel/:id/join
Body: { token: string }
说明:将 token 绑定到频道,无需校验。
POST https://pingo.minapp.xin/channel/:id/leave
Body: { token: string }
说明:解绑频道成员。
POST https://pingo.minapp.xin/channel/:id/settings
Body: { key?: string|null, nextKey?: string|null }
说明:设置/清除频道推送 key;若已设置需携带当前 key,可用 nextKey 修改。
POST https://pingo.minapp.xin/channel/:id/push
Body: { content: string, type?: string, meta?: object, key?: string }
说明:广播给频道成员的 token 监听者(/:token/listen),key 仅用于推送鉴权。
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>/push?content=Build%20done"
监听
curl https://pingo.minapp.xin/<token>/listen
Token 主页(推送/监听入口)
https://pingo.minapp.xin/token?token=<token>
频道推送
curl -X POST https://pingo.minapp.xin/channel/demo/push -H 'Content-Type: application/json' -d '{"content":"Hello channel"}' 说明
- 消息不落盘,只面向当前在线监听者。
- 同一 token 可多端同时监听;推送会广播到该 token 的所有在线连接;welcome 仅发送给新连接本身。
- 频道 key 仅用于推送鉴权;丢失 token 视为权限泄露,建议定期轮换。
- 建议网关层增加限流与最大 body 限制,保证稳定性。