Consulta de detalles de terminal
Descripción
Esta API es utilizada por un administrador de empresa para consultar los detalles del terminal.
SLA
Tasa de éxito de solicitudes: > 99.99%
Retardo de solicitud TP99: 110 ms
Depuración
Puede depurar esta API en API Explorer.
Prototipo
Método de solicitud |
GET |
---|---|
Dirección de solicitud |
/v1/usg/dcs/corp/device/{sn} |
Protocolo de transporte |
HTTPS |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Localización |
Descripción |
---|---|---|---|---|
sn |
Sí |
String |
Path |
Terminal de SN. El valor solo puede contener números, letras y guiones bajos (_). maxLength: 30 minLength: 1 |
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. |
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 |
---|---|---|
account |
String |
Cuenta incorporada del terminal duro. |
country |
String |
|
deptCode |
String |
Código de departamento. |
deptName |
String |
Nombre del departamento. |
deptNamePath |
String |
Ruta del nombre del departamento. |
description |
String |
Descripción de los terminales. |
|
String |
Dirección de correo. |
model |
String |
Modelo del dispositivo. El valor es un tipo enumerado. Actualmente, solo se admiten terminales duros de la serie TE. Puede obtener los modelos de terminal usando la API en Obtención de todos los modelos de terminal. |
name |
String |
Nombre del dispositivo. |
number |
String |
Número SIP enlazado a la terminal. |
phone |
String |
Número de móvil. |
prjCodeMode |
Integer |
Modo de generación de código de proyección.
|
sn |
String |
Terminal de SN. El valor solo puede contener números, letras y guiones bajos (_). |
status |
Integer |
Estado de la terminal.
|
type |
String |
Tipo de terminal, que se utiliza para distinguir los terminales desarrollados por Huawei o de terceros. |
Ejemplo de solicitud
GET /v1/usg/dcs/corp/device/asdasfscasd Connection: keep-alive X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)
Ejemplo de respuesta
HTTP/1.1 200 Date: Wed, 18 Dec 2019 06:20:40 GMT Content-Type: application/json;charset=UTF-8 Content-Length: 407 Connection: keep-alive Pragma: No-cache Cache-Control: no-cache Server: api-gateway X-Request-Id: efa03c0b6cb71b96129744f5a1a8a736 { "name": "test", "type": "TE", "model": "TE20", "sn": "asdasfscasd", "account": "df8bce2178294683bb83a4985fef7165", "number": "+991118029589", "prjCodeMode": 0, "deptCode": "1", "deptName": "wangyue", "deptNamePath": "wangyue", "phone": "+86***********", "country": "chinaPR", "email": "test@huawei.com", "description": "test", "status": 0 }
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 -X GET -H 'X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/device/asdasfscasd