导入单聊消息
https://zim-api.zego.im/
如果您正使用其他即时通讯服务并希望接入 ZIM,可调用此接口,向 ZIM 导入用户的历史单聊消息(按时间顺序)。
一个单聊会话存在两个用户(用户 A、B)。用户 A 可能删除了部分消息,导致用户 A 在此会话可以看到的消息列表与用户 B 的不同,因此,对于同一个单聊会话,需要为用户 A、B 分别调用此接口。
参数 FromUserId、ToUserId 仅支持数字、英文字符和 {'!','#','$','%','&','(',')','+','-',':',';','<','=','.','>','?','@','[',']','^','_',' ','{','}','|','~'}。
为了给开发者带来更好的体验,ZEGO 推荐开发者使用最新版本的 SDK。
如果发送方请求发送 MessageType 为 1 的文本消息,则发送方对应的客户端(SDK 版本需为 2.7.0 或以上)也会收到该消息。
对于发送和接收 MessageType 为 200 的自定义消息,发送方和接收放对应的客户端的 SDK 版本需为 2.8.0 或以上。
如果接收端的 SDK 版本介乎 [2.0.0, 2.8.0) 区间,可以收到自定义消息时,但会显示此消息类型为未知,且无法获取信息内容。如需获取此条消息,请将 SDK 升级为 2.8.0 或以上版本。
如果接收端的 SDK 版本为 1.x.x 版本,则无法收到自定义消息,也不会收到未知消息。
验证效果
成功导入消息后,可调用 ZIM 服务端接口 查询单聊会话消息列表,确认用户的单聊会话消息是否导入完整。
Request
Query Parameters
可选值: [ImportPeerMsg]
接口原型参数
https://zim-api.zego.im/?Action=ImportPeerMsg
💡公共参数。应用 Id,由 ZEGO 分配的用户唯一凭证。可从 ZEGO 控制台 获取。
💡公共参数。16 位 16 进制随机字符串(8 字节随机数的 hex 编码)。生成算法可参考 签名示例。
💡公共参数。当前 Unix 时间戳,单位为秒。生成算法可参考 签名示例,最多允许 10 分钟的误差。
可选值: [2.0]
默认值: 2.0
💡公共参数。签名版本号。
💡公共参数。签名,用于验证请求的合法性。请参考签名机制生成。
- application/json
Responses
- 200
- application/json
- curl
- python
- go
- nodejs
- ruby
- csharp
- php
- java
- powershell
- CURL

