差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 上一修订版 两侧同时换到之后的修订记录 | ||
im:server:basics:chatrecord [2019/11/01 06:41] huanxinfudh [REST API] |
im:server:basics:chatrecord [2020/09/17 03:18] huanxinfudh [获取历史消息文件] |
||
---|---|---|---|
行 14: | 行 14: | ||
|from|发送人username| | |from|发送人username| | ||
|to|接收人的username或者接收group的ID| | |to|接收人的username或者接收group的ID| | ||
- | |chat_type|用来判断单聊还是群聊。chat: 单聊;groupchat: 群聊| | + | |chat_type|用来判断单聊、群聊还是聊天室。chat: 单聊;groupchat: 群聊;chatroom: 聊天室| |
|payload|消息bodies,不同的消息类型;消息ext,自定义扩展属性等| | |payload|消息bodies,不同的消息类型;消息ext,自定义扩展属性等| | ||
行 212: | 行 212: | ||
**重要提醒:**获取 token 时服务器会返回 token 有效期,具体值参考接口返回的 expires_in 字段值。由于网络延迟等原因,系统不保证 token 在此值表示的有效期内绝对有效,如果发现 token 使用异常请重新获取新的 token,比如“http response code”返回 401。另外,请不要频繁向服务器发送获取 token 的请求,同一账号发送此请求超过一定频率会被服务器封号,切记,切记!! | **重要提醒:**获取 token 时服务器会返回 token 有效期,具体值参考接口返回的 expires_in 字段值。由于网络延迟等原因,系统不保证 token 在此值表示的有效期内绝对有效,如果发现 token 使用异常请重新获取新的 token,比如“http response code”返回 401。另外,请不要频繁向服务器发送获取 token 的请求,同一账号发送此请求超过一定频率会被服务器封号,切记,切记!! | ||
+ | |||
+ | ''此接口一次只能获取一个小时的历史消息'' | ||
client_id 和 client_secret 可以在环信管理后台的 [[http://www.google.com|APP 详情页面]]看到。 | client_id 和 client_secret 可以在环信管理后台的 [[http://www.google.com|APP 详情页面]]看到。 | ||
行 256: | 行 258: | ||
"applicationName": "testapp" | "applicationName": "testapp" | ||
} | } | ||
+ | |||
+ | 注意:url是有过期时间的,url中的Expires对应的时间戳就是过期时间(秒),请及时通过url下载聊天记录文件,过期后会下载不到,需要重新调用"获取历史消息文件"接口获取新的url。 | ||
</code> | </code> | ||
行 284: | 行 288: | ||
> 提示 | > 提示 | ||
+ | |||
+ | 极少数情况下,聊天记录中的消息可能重复地被记录。 | ||
查询的时间格式为10位数字形式(YYYYMMDDHH),例如要查询2016年12月10号7点到8点的历史记录,则需要输入2016121007,7:00:00的信息也会包含在这个文件里。 | 查询的时间格式为10位数字形式(YYYYMMDDHH),例如要查询2016年12月10号7点到8点的历史记录,则需要输入2016121007,7:00:00的信息也会包含在这个文件里。 |