批量获取用户的在线状态。目前包括如下三个呼叫状态: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"
}