Skip to main content

获取消息状态

域名

  • https://chat-api.incsapp.com

请求路由

  • /external/messages/status

请求方式

  • GET

请求头

  • certification-code: af92196e-0d07-3c1d-a631-a71c...

请求参数

请求参数列表

参数名 类型 必填 描述
message_ids string 消息id列表,必须是以英文逗号分隔的字符串,最多100个消息id。如:message_ids=wamid.HBgNNjI4MTUxOTE0MDMyNxUCABEYEkUwMzZEMDc4RURERDlFQzFBNQA=,wamid.HBgLODUyNjg0MTUwMjYVAgARGBI4QTJBNjQ5MzA5NTgwRTBBMkQA

响应

  • 请注意该接口获取的消息状态可能会有数分钟延迟

成功响应示例

{
    "status": "success",
    "code": 200,
    "message": "",
    "data": {
        "data": [
            {
                "message_id": "wamid.HBgNNjI4MTUxOTE0MDMyNxUCABEYEkUwMzZEMDc4RURERDlFQzFBNQA=",
                "message_status": "read", // 消息最终状态
                "created_at": 1774249921, // 消息创建时间戳
                "delivered_at": 0, // 消息送达时间戳(这里被read覆盖所以没有记录delivered_at)
                "read_at": 1774249929 // 消息已读时间戳
            },
            {
                "message_id": "wamid.HBgLODUyNjg0MTUwMjYVAgARGBI4QTJBNjQ5MzA5NTgwRTBBMkQA",
                "message_status": "read",
                "created_at": 1773907696,
                "delivered_at": 1773907751,
                "read_at": 1773907751
            }
        ]
    },
    "error": {}
}