Consulta de códigos de activación por página como administrador de empresa
Descripción
Esta API es utilizada por un administrador de empresa para consultar códigos de activación por página. Se admite la consulta difusa por código de activación o nombre de terminal.
Depuración
Puede depurar esta API en API Explorer.
Prototipo
|
Método de solicitud |
GET |
|---|---|
|
Dirección de solicitud |
/v1/usg/dcs/corp/vision/activecode |
|
Protocolo de transporte |
HTTPS |
Parámetros de solicitud
|
Parámetro |
Obligatorio |
Tipo |
Localización |
Descripción |
|---|---|---|---|---|
|
offset |
No |
Integer |
Query |
Desplazamiento de consulta. Si el valor excede el número máximo de registros disponibles, se devuelven los registros de la última página. Valor predeterminado: 0. |
|
limit |
No |
Integer |
Query |
Número de registros a consultar. Valor predeterminado: 10. |
|
searchKey |
No |
String |
Query |
Criterios de búsqueda. Se admite la búsqueda difusa por código de activación o nombre de terminal. |
|
devType |
No |
String |
Query |
Tipo de terminal.
|
|
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 una UUID. Si este parámetro no se incluye, se genera automáticamente una 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 no vá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 |
|---|---|---|
|
count |
Integer |
Número total de registros. |
|
limit |
Integer |
Número de registros mostrados por página. Valor predeterminado: 10. |
|
offset |
Integer |
Número de la página de inicio de la consulta. El valor comienza desde 0. |
|
data |
Array of QueryVisionActiveCodeResultDTO objects |
Información del código de activación por página. |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
activeCode |
String |
Código de activación. |
|
deptCode |
String |
Código de departamento. |
|
deptName |
String |
Nombre de departamento. |
|
devName |
String |
Nombre de terminal. |
|
devType |
String |
Tipo de terminal. |
|
expireDate |
Long |
Marca de tiempo de vencimiento. |
|
id |
String |
ID única del código de activación. |
Ejemplo de solicitud
GET /v1/usg/dcs/corp/vision/activecode Connection: keep-alive X-Access-Token: stbWbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOD 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: Tue, 17 Dec 2019 09:32:47 GMT
Content-Type: application/json;charset=UTF-8
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 639e8b710378987ffc5eb844b5e5c291
{
"count": 1,
"data": [
{
"activeCode": "324****97",
"deptCode": "1",
"deptName": "Test Department",
"devName": "test_device",
"devType": "idea-hub",
"expireDate": 1611250137942,
"id": "6d35397d67504dd1b7e1766a25f1be12"
}
],
"limit": 10,
"offset": 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 en Centro de errores de la API de Huawei Cloud.
Ejemplo de comando cURL
curl -k -i -X GET -H 'X-Access-Token: stbWbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOD' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/vision/activecode
