查询单条消息 - 即时通信

请求参数

Path 参数

conversation_id

string

必需

会话 ID。会话 ID 需要用户自行拼装，拼装规则：
sender_id|conversation_type|receiver_id
sender_id：会话消息发送者的账号 ID，String 类型
conversation_type：会话类型，1：单聊会话；2：高级群会话；3：超大群会话
receiver_id：接收会话消息的账号 ID 或群组 ID
单聊会话时为消息接收者的账号 ID；高级群会话时为接收消息的高级群 ID；超大群会话时为超大群 ID。

示例值:

apifoxtest35|1|apifoxtest40

message_server_id

string

必需

需要查询的服务端消息 ID。

示例值:

9846685680753

Header 参数

AppKey

string

必需

默认值:

X-custom-traceid

string

可选

默认值:

{% mock 'uuid' %}

Nonce

string

必需

默认值:

CurTime

string

必需

默认值:

CheckSum

string

必需

默认值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

msg

string

必需

data

object

必需

attachment

object

可选

多媒体消息的属性或自定义消息内容。

message_server_id

integer <long>

必需

服务端消息 ID。

sender_id

string

必需

消息发送方帐号 ID。

conversation_type

integer

必需

会话类型，1：单聊会话；2：高级群会话；3：超大群会话。

receiver_id

string

可选

消息接收方账号 ID。

create_time

integer <long>

消息发送时间戳。

必需

message_type

integer

必需

消息类型。0：文本；1：图片；2：语音；3：视频；4：地址位置；5：通知；6：文件；10：提示；11：机器人；100：自定义。

text

string

可选

文本/提示消息内容或多媒体消息的描述文本（该描述信息可用于云端历史消息关键词检索）。

team_id

integer <long>

可选

群组 ID。team_id 与 receiver_id 只会返回其一。

sub_type

integer

可选

自定义消息子类型。

modify_account_id

string

可选

消息更新者的用户账号 ID。
只有消息被更新才会返回该字段。

modify_time

number

可选

消息的更新时间。
只有消息被更新才会返回该字段。

thread_config

object

Thread 消息配置项。

可选

示例

  "code": 200,
  "msg": "success",
  "data": {
    "attachment": {
      "dur": 4272,
      "ext": "aac",
      "size": 15469,
      "url": "https://nim-nosdn.netease.im/MTAxMTAwMg\u003d\u003d/bmltYV80MjA4OTlfMTYzODg0MzA5NjI3NV82ZmJjM2MyZS1iMjJkLTRiNTUtYTk0ZS0yYzEwNzlhMzg2YWI\u003d?audioTrans\u0026type\u003dmp3",
      "md5": "5b73c370-52e6-4c07-ae48-7e6d98c693b5"
    },
    "message_server_id": 9846685680753,
    "sender_id": "apifoxtest35",
    "conversation_type": 1,
    "receiver_id": "apifoxtest40",
    "create_time": 1707030172542,
    "message_type": 2
  }
}

🟢200成功

🟢200请求参数错误

🟢200服务器错误