实时消息路由

使用场景

极光可以帮助开发者实现以下场景：

  • 在 APP 自己的服务端实时保存聊天历史
  • 开发者可以实现针对客户消息的内容进行自动回复
    如需要开通此功能，请联系：商务客服；如果开发者没有实时性需求，建议使用免费的IM REST Report拉取历史消息。

目前服务支持https和http回调

关于开发者鉴权的问题，为了防止开发者服务被随意调用，开发者服务验证采用 HTTP Basic 机制，即 HTTP Header（头）里加一个字段（Key/Value对）：

Authorization: Basic base64_auth_string

其中 base64_auth_string 的生成算法为：base64(appKey:masterSecret)

即，对 appKey 加上冒号，加上 masterSecret 拼装起来的字符串，再做 base64 转换。

msg callback在请求的时候会带上Authorization: Basic base64_auth_string让开发者服务进行验证

https 接口采用post方法

Request header

  1.   Content-Type: application/json; charset=utf-8

Request Body

  1.  { 
  2.  "total":1,
  3.  "messages":[ 
  4.  { 
  5.   "target_type":"single",
  6.   "msg_type":"text",
  7.   "target_name":"JMessage",
  8.   "target_id":"10000002",
  9.   "from_id":"10000001",
  10.   "from_name":"JPush",
  11.   "from_type":"user",
  12.   "from_platform":"a",
  13.   "msg_body":{ 
  14.    "text":"text",
  15.    "extras":{ 
  16.    }
  17.   },
  18.  "create_time":1446016259,
  19.  "version":1,
  20.  "msgid":12345678,
  21.  "msg_level": 0,
  22.  "msg_ctime" : 1466866468352 // 服务器接收到消息的时间，单位毫秒  
  23.  }
  24.  ]
  25. }

与REST Report历史消息获取的消息格式相同

msg callback 所需的成功响应

Response

  1.   HTTP/1.1 200  
  2.   Content-Type: application/json; charset=utf-8