API 接入

消息流程:

  1. 开发者通过调用 超级消息 API 主动推送消息到指定客户端,以下情形适用本流程:

    • 当您想主动推送消息给用户的时候
    • 当您想保存这条消息的时候(服务端目前会保留 7 天的离线消息)
    • 当您想把一条消息同步给其他用户的时候
  2. 用户操作客户端直接与开发者服务器通讯

sequenceDiagram participant 客户端 participant 平台服务器 participant 开发者服务器 开发者服务器-->>平台服务器: 给用户推送消息(异步) 平台服务器->>客户端: 下达消息(到达多设备) 客户端->>开发者服务器: 提交 JSON 数据(用户与您的服务直接互动) 开发者服务器->>客户端: 返回 JSON 数据(用户与您的服务直接互动)

在查看 API 之前,先记住两个重要的 token,requestTokenaccessToken

  • requestToken 是客户端向您发起请求时带上的,用于验证请求的合法性,所以客户端总是带着此 token 请求您的服务器

  • accessToken 则是平台赋予某个频道用来访问平台 API 权限的钥匙,所以只要是访问平台接口,就必须带上 accessToken