Loading...

    批量获取用户的在线状态

    功能说明

    批量获取用户的在线状态。目前包括如下三个呼叫状态:OFFLINE(离线)/IDLE(空闲)/INCALL(呼叫中),不同软终端同时登陆时,优先级OFFLINE < IDLE < INCALL

    默认接口请求频率限制:20 次/秒

    实现方法

    REST URL

    POST: /api/rest/external/v1/userInfo/onlineState/numbers?enterpriseId=xxx&signature=xxx


    请求参数说明:

    参数

    参数类型

    参数位置

    必须

    默认值

    说明

    初始平台

    enterpriseId

    String

    Query

    企业ID

    分区云 5.2-20250926

    公有云

    []

    List

    Body

    账号集合,不能超过 50 个

    分区云 5.2-20250926

    公有云

    示例代码

    示例

    ["1234556","654321"]

    返回结果示例:

    成功时返回结果数据,失败时返回小鱼RESTAPI错误

    {
    "123456":"INCALL",
    "654321":"OFFLINE"
    }

    请求失败结果示例

    {
    "developerMessage": "ErrorStatus: SDK_INVALID_APPKEY No app found for extId: ",
    "userMessage": "sdk.invalid.key",
    "errorCode": 60001,
    "moreInfo": "http://www.com.ainemo.com/errors/60001"
    }


    意见反馈