检索历史消息

GET

/im/v2.1/messages/actions/search_messages

请求参数

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request GET 'https://open.yunxinapi.com/im/v2.1/messages/actions/search_messages?operator_id=user123&conversation_id=account1|1|account2&sender_account_ids=sender1&message_types=0&message_sub_types=1&start_time=1723000000000&time_period=86400000&direction=0&keyword_list=["hello","world"]&keyword_match_type=0&page_token=abc123&limit=100' \
--header 'AppKey;' \
--header 'X-custom-traceid: {% mock '\''uuid'\'' %}' \
--header 'Nonce;' \
--header 'CurTime;' \
--header 'CheckSum;'

返回响应

🟢200成功

application/json

Body

示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "count": 3,
    "has_more": false,
    "next_token": "",
    "items": [
      {
        "text": "{\"msg\":\"2025-07-31T16:50:03.534文本消息测试-单聊-检索检索8s4\"}",
        "extension": "ext",
        "message_server_id": 158844553334358020,
        "sender_id": "test36",
        "message_client_id": "7cdb40***e03639c7",
        "conversation_type": 2,
        "team_id": 2366968294,
        "create_time": 1753951805248,
        "message_type": 0,
        "sub_type": 1,
        "receiver_account_ids": [
          "test69"
        ],
        "inclusive": true,
        "new_member_visible": false,
        "modify_account_id": "test36",
        "modify_time": 1753951811315,
        "thread_config": {
          "thread_root": {
            "sender_id": "test36",
            "receiver_id": "2366968294",
            "create_time": 1753951803793,
            "message_server_id": 158844553334358018,
            "message_client_id": "63293***2596b183"
          },
          "thread_reply": {
            "sender_id": "test36",
            "receiver_id": "2366968294",
            "create_time": 1753951803793,
            "message_server_id": 158844553334358018,
            "message_client_id": "63293***596b183"
          }
        },
        "sender_client_type": 32
      }
    ]
  }
}

🟢200成功

🟢200请求参数错误

🟢200服务器错误

修改于 2025-08-07 03:24:19

分页查询历史消息

查询 Thread 消息