隔天获取历史记录

获取历史记录接口是云通讯平台为开发者提供的隔天获取im历史记录的接口。该接口支持按天获取,获取的是应用下所有账号的消息记录。该接口目前仅供专有云使用。

如果要使用该接口,需要在控制台IM管理页面—>选择应用—>点击IM专业版功能配置—>进入历史消息页面,勾选按天生成历史消息记录。当天勾选后,第二天可以获取历史记录。

官网可自行下载历史记录文件。点击”IM专业功能配置-历史消息下载”,可下载隔天历史消息文件。每个文件只能下载一次。缺省仅提供一个月的下载列表;如果单独购买了历史记录延长服务,购买几个月,则可以多看几个月;详情查看历史消息下载

       

1、请求地址

  • POST /2013-12-26/Application/{appId}/IM/GetMsgRecordsFile

        

2、请求包头

请参阅《鉴权说明

3、请求包体

属性类型约束说明
date String 可选

消息日期,如不填默认取前一天或前一周

time_type为day时,为消息数据当天日期,格式‘yyyy-mm-dd’;

type String 可选 时间类型,天:day

4、请求示例       

  • POST /2013-12-26/Application/20150314000000110000000000000010/IM/GetMsgRecordsFile?sig=C1F20E7A97 
  • HTTP/1.1
  • Accept:application/json;
  • Content-Type:application/json;charset=utf-8;
  • Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyM=

  • {"date":"2017-12-23","type":"day"} 

        

5、响应包体

注: 使用fileUrl下载时,请在fileUrl后拼接?fileToken={fileToken},fileToken为响应中的fileToken。返回的消息记录文件只能下载一次,请注意保存消息文件。 

属性类型约束说明                                                                                                         
statusCode String 必选 请求状态码,取值000000(成功)。
fileToken String 必选 下载文件校验码
fileUrl String 必选 下载URL

6、响应示例

   

7、历史文件参数说明

 属性                                                                                      
 说明                                                                                    
app_id_sender 发送方appkey
msg_sender 发送者
app_id_receiver 接收方appkey
msg_receiver 接收者
device_type
发送者设备类型  
1: Android Phone 
2: iPhone  
10: iPad  
11: Android Pad  
20: PC  
21: H5
msg_len 消息长度
msg_type
消息类型
1:文本消息
2:语音消息
3:视频消息
4:图片消息
5:位置消息
6:文件
msg_content 消息内容
msg_file_url 附件下载地址
msg_file_name 附件名称
group_id 群组ID
msg_id 消息ID
msg_file_size 附件大小,单位字节
date_created 创建时间
msg_domain 自定义数据,需要based64解密
ext_opts 平台扩展信息
msg_id 消息ID
msg_file_size 附件大小,单位字节
date_created 创建时间
msg_domain 自定义数据,需要based64解密
ext_opts 平台扩展信息