批量获取账号在线状态

开发中

POST

/im/v2/users/actions/onlineStatus

云信支持批量查询账号的在线状态，一次最多可查询 100 个账号。如果提供的账号列表中account_id不存在或者用户信息不存在，则会返回查询失败的账号列表。

请求参数

Header 参数

Body 参数application/json

示例

{
    "account_ids": [
        "string"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.yunxinapi.com/im/v2/users/actions/onlineStatus' \
--header 'AppKey;' \
--header 'X-custom-traceid: {% mock '\''uuid'\'' %}' \
--header 'Nonce;' \
--header 'CurTime;' \
--header 'CheckSum;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "account_ids": [
        "string"
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "msg": "string",
    "data": {
        "success_list": [
            {
                "account_id": "string",
                "online_status": [
                    {
                        "client_type": 0,
                        "login_time": 0
                    }
                ]
            }
        ],
        "failed_list": [
            {
                "account_id": "string",
                "error_code": 0,
                "error_msg": "string"
            }
        ]
    }
}

🟢200成功

🟢200请求参数错误

🟢200服务器错误

修改于 2025-01-14 06:02:16

批量查询用户名片

添加好友