文档首页

消息历史日志

下载地址获取¶

说明：免费获取 APP 内指定某天某小时内的所有会话消息记录的下载地址（目前支持二人会话、讨论组、群组、聊天室、客服、系统通知消息历史记录下载。），消息记录以日志文件方式提供，并对文件进行 ZIP 压缩。

方法名：/message/history

签名方法：请参考通用 API 接口签名规则

URL：http(s)://api-cn.ronghub.com/message/history.[format]

[format] 表示返回格式，可以为 json 或 xml，注意不要带 [ ]。

HTTP 方法：POST

表单参数

名称	类型	说明
date	String	指定北京时间某天某小时，格式为2014010101，表示获取 2014 年 1 月 1 日凌晨 1 点至 2 点的数据。（必传）

注：如您的业务是在新加坡数据中心，则消息历史日志服务所使用的时间为 UTC 时，获取消息日志时使用的时间及日志中的消息时间需要根据需要自行转换处理。如要下载北京时间 2019120109 的日志，需要输入 2019120101。

返回值

名称	类型	说明
code	Int	返回码，200 为正常。
url	String	历史记录下载地址，如没有消息记录数据时，则 `url` 值为空。
date	String	历史记录时间。

JSON 格式：

{
  "code":200,
  "url":"http://aa.com/1/c6720eea-452b-4f93-8159-7af3046611f1.zip",
  "date":"2014010101"
}

XML 格式：

<xml>
  <code>200</code>
  <url>http://aa.com/1/c6720eea-452b-4f93-8159-7af3046611f1.zip</url>
  <date>2014010101</date>
</xml>

提示

消息记录以日志方式提供，并对文件进行 ZIP 压缩，通过该接口返回消息记录文件下载地址后，请自行下载。

消息记录数据每小时产生一次，例如 10 点的数据，在 11 点以后才能调用该接口获取到下载地址，在获取时可能会出现延迟，请尝试多次获取，最晚 1 小时即可获取到下载地址。

消息记录日志文件，我们为您在服务器端保存 3 天，无论是否下载过，3 天后都将从服务器删除。

开发者如果需要获取图片、视频等文件信息，可通过消息中地址进行下载，融云文件存储有效期为 6 个月。

日志文件中，消息格式为 json ：

{
    "appId": "8w7jv4qb7k5wy",
    "fromUserId": "99921",
    "targetId": "4974",
    "targetType": 3,
    "GroupId": "4971",
    "classname": "RC:TxtMsg",
    "content": {
        "content": "求帮助"
    },
    "dateTime": "2015-05-27 08:18:30.709",
    "source":"iOS",
    "isDiscard":"false",
    "isSensitiveWord":"false",
    "isForbidden":"false",
    "isNotForward":"false",
    "groupUserIds":[321,232],
    "msgUID": "596E-P5PG-4FS2-7OJK"
}

格式说明

名称	类型	说明
appId	String	App Key。
fromUserId	String	发送者 Id
targetId	String	接受者 Id，在消息路由中为 `toUserId`。
targetType	Int	会话类型，二人会话是 `1` 、讨论组会话是 `2` 、群组会话是 `3` 、聊天室会话是 `4` 、客服会话是 `5` 、系统通知是 `6` 、应用公众服务是 `7` 、公众服务是 `8`。`targetType` 在 SDK 中为 `ConversationType`。
GroupId	String	根据不同的 targetType，可能是讨论组 Id、群组 Id 或聊天室 Id ，如 targetType 为 1 时可忽略 GroupId。
classname	String	消息类型：文本消息 `RC:TxtMsg` 、图片消息 `RC:ImgMsg` 、语音消息 `RC:VcMsg` 、图文消息 `RC:ImgTextMsg` 、位置消息 `RC:LBSMsg` 、添加联系人消息 `RC:ContactNtf` 、提示条通知消息 `RC:InfoNtf` 、资料通知消息 `RC:ProfileNtf` 、通用命令通知消息 `RC:CmdNtf` ，详细请参见消息类型说明文档。
content	String	消息内容
dateTime	String	消息时间
source	String	消息来源，包括：iOS、Android、Websocket、MiniProgram（小程序）。
isDiscard	String	是否被丢弃，true 为是，false 为否，只针对聊天室会话类型存在。
isSensitiveWord	String	是否含有敏感词，true 为含有敏感词、false 为不含有敏感词，只针对聊天室会话类型存在。
isForbidden	String	是否为被禁言后发送的消息，只针对聊天室会话类型存在。
isNotForward	String	消息是否不分发，true 为不分发、false 为分发，只针对聊天室会话类型存在。
msgUID	String	可通过 `msgUID` 确定消息唯一。
groupUserIds	String[]	`targetType` 为 `3` 时此参数有效，显示为群组中指定接收消息的用户 ID 数组，该条消息为群组定向消息。非定向消息时内容为空，如指定的用户不在群组中内容也为空。

示例

Request：

POST /message/history.json HTTP/1.1
Host: api-cn.ronghub.com
App-Key: uwd1c0sxdlx2
Timestamp: 1408710653491
Nonce: 14314
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: Application/x-www-form-urlencoded

date=2014010101

Response：

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "code":200,
  "url":"http://aa.com/1/c6720eea-452b-4f93-8159-7af3046611f1.gz",
  "date":"2014010101"
}

历史记录删除¶

说明：删除服务端消息记录日志文件，文件内容为 APP 内指定某天某小时内的所有会话消息记录，删除后文件将在随后的 10 分钟内被永久删除。开通单群聊消息云存储功能后存储在云端的数据不会被删除，只是无法再通过“消息历史记录下载地址获取方法”获取消息日志文件。

方法名：/message/history/delete