Consulta del estado de la terminal
Descripción
Esta API se utiliza para consultar el estado de un terminal dura.
El terminal duro y la cuenta que inicia la solicitud de consulta deben pertenecer a la misma empresa. De lo contrario, la autenticación falla.
SLA
Tasa de éxito de solicitudes: > 99.99%
Retardo de solicitud TP99: 101 ms
Depuración
Puede depurar esta API en API Explorer.
Prototipo
Método de solicitud |
POST |
---|---|
Dirección de solicitud |
/v1/usg/acs/ap/userstatus |
Protocolo de transporte |
HTTPS |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Localización |
Descripción |
---|---|---|---|---|
X-Access-Token |
Sí |
String |
Header |
Token de autorización. Utilice el valor de accessToken en la respuesta a la solicitud de Autenticación de un ID de aplicación. |
X-Request-Id |
No |
String |
Header |
ID de solicitud, que se utiliza para el seguimiento y la localización de fallos. Se recomienda utilizar un UUID. Si este parámetro no se incluye, se genera automáticamente un ID de solicitud. |
Accept-Language |
No |
String |
Header |
Idioma. Valores: zh-CN para chino (predeterminado) y en-US para inglés. |
[Array element] |
Sí |
Array of strings |
Body |
Número de terminal a consultar. |
Códigos de estado
Código de estado de HTTP |
Descripción |
---|---|
200 |
Operación exitosa. |
400 |
Parámetros inválidos. |
401 |
La autenticación no se realiza o falla. |
403 |
Permisos insuficientes. |
500 |
Excepción del servidor. |
Parámetros de respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
[Array element] |
Array of UserStatusDTO |
Lista de estados de dispositivos. |
Parámetro |
Tipo |
Descripción |
---|---|---|
CallStatus |
String |
Estado de la llamada.
|
Number |
String |
Número de terminal. |
RegStatus |
String |
Estado de registro.
|
Ejemplo de solicitud
POST /v1/usg/acs/ap/userstatus Connection: keep-alive X-Access-Token: stbtsadx6U2jBKxODtf3Ylnff5uGZX8mzu1K content-type: application/json Content-Length: 40 Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_131) [ "+99*******" ]
Ejemplo de respuesta
HTTP/1.1 200 Date: Wed, 18 Dec 2019 06:20:40 GMT Content-Type: application/json;charset=UTF-8 Connection: keep-alive Pragma: No-cache Cache-Control: no-cache Server: api-gateway X-Request-Id: a48502799c8d43519ba81502110cf213 [ { "Number": "tel:+991116173924", "RegStatus": "0", "CallStatus": "1" } ]
Códigos de error
Si se devuelve un código de error que comienza con MMC o USG cuando utiliza esta API, corrija el error siguiendo las instrucciones proporcionadas enCentro de errores de la API de Huawei Cloud.
Ejemplo de comando cURL
curl -k -i -H 'content-type: application/json' -X POST -H 'X-Access-Token: stbtsadx6U2jBKxODtf3Ylnff5uGZX8mzu1K' -d '["+99*******"]' https://api.meeting.huaweicloud.com/v1/usg/acs/ap/userstatus