• 实时消息路由
    • 使用场景
    • 目前服务支持https和http回调
      • https 接口采用post方法
      • msg callback 所需的成功响应

    实时消息路由

    使用场景

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

    • 在 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