请登录后查看
ShowDeviceStatus
查询设备状态
调用本接口可以查询硬终端的状态。 硬终端与发起查询请求的帐号需在同一企业下,否则会鉴权失败。
名称 | 类型 | IN | 必选 | 描述 |
---|---|---|---|---|
Accept-Language | string | header | 否 | 语言参数,默认为中文zh-CN,英文为en-US。 |
X-Request-ID | string | header | 否 | 请求requestId,用来标识一路请求,用于问题跟踪定位,建议使用UUID,若不携带,则后台自动生成。 |
X-Access-Token | string | header | 是 | token鉴权 |
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
[数组元素] | Array of strings | 是 | 所请求查询的终端的号码。 |
操作成功。
名称 | 类型 | 描述 |
---|---|---|
[数组元素] | Array of UserStatusDTO objects |
名称 | 类型 | 描述 |
---|---|---|
Number | string | 终端号码 |
RegStatus | string | 注册状态。
|
CallStatus | string | 呼叫状态。
|
鉴权失败 业务返回码
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
没有权限 业务返回码
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
服务端异常 业务返回码
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
"POST https://{endpoint}/v1/usg/acs/ap/userstatus"
[
"80001236"
]
操作成功。
[
{
"Number": "80001236",
"RegStatus": "0",
"CallStatus": "1"
}
]