Surprising API

把消息能力
接入你的产品.

Surprising API 面向开发者开放 App 内消息能力。你的服务可以向自己、好友或群聊发送通知、提醒、业务消息和自动化工作流消息。当前页面仅展示平台设计，不开放真实调用。

Messages API REST endpoint preview

Design Preview

POST https://api.surprising.top/v1/messages
Authorization: Bearer $SURPRISING_API_KEY
Content-Type: application/json

{
  "target_type": "friend",
  "target_id": "surprising_user_id",
  "message_type": "text",
  "content": {
    "text": "Your deployment finished successfully."
  },
  "dedupe_key": "deploy-2026-05-23-001"
}

Use Cases

从系统事件到群通知

API 的核心不是替代聊天，而是把外部系统的关键事件可靠送达到 Surprising 内部关系链。

发送给自己

把部署结果、监控告警、账单提醒或交易状态发给自己的 Surprising 账号。

selfalert

发送给好友

在双方授权的场景下，把订单进度、邀请消息、协作提醒发送给指定好友。

friendnotify

发送到群聊

把项目发布、团队值班、活动报名、交易汇总等消息推送到群聊。

groupbroadcast

未来消息

为产品里的预约、纪念日、订阅到期和任务截止时间创建可延迟触达的消息。

schedulefuture

Flow

建议的接入流程

正式开放前，平台会优先提供最小可用闭环：身份、授权、发送、回执和速率限制。

创建应用

在开发者控制台创建应用，生成 API Key，并配置回调地址和允许发送的消息类型。

用户授权

用户确认你的应用可以向自己、好友或指定群聊发送消息，授权范围必须清晰可撤销。

调用发送接口

使用幂等键、目标类型和消息内容发起请求，平台返回 message_id 用于追踪。

接收回执

通过 Webhook 接收发送、送达、失败和限流状态，便于业务侧补偿或重试。

Principles

默认尊重用户关系和通知边界

消息 API 会把授权、限流、审计和反滥用放在第一优先级。开发者只能在用户明确授权的关系内发送。

最小权限

API Key 按应用、环境和权限范围拆分，生产密钥可轮换、可撤销。

反滥用

速率限制、内容审计、黑名单和用户退订机制会成为默认能力。

可追踪

每条消息都有请求 ID、幂等键和状态回执，方便排查与审计。

隐私保护

开发者无法枚举用户关系，发送目标必须来自授权或业务侧已确认的绑定。

开发者平台正在设计中。

当前页面用于展示产品方向。正式开放时会提供控制台、沙盒环境、Webhook 调试、SDK 示例和完整 API 文档。

进入 Surprising App

把消息能力接入你的产品.