Pingo

快捷的全平台推送方案

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 限制,保证稳定性。