Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2023-01-31 GMT+08:00

Verificación de un código de verificación

Descripción

Esta API se utiliza para verificar un código de verificación enviado a un número de teléfono móvil y dirección de correo electrónico. Se permiten hasta cinco intentos de verificación por minuto.

Depuración

Puede depurar esta API en API Explorer.

Prototipo

Tabla 1 Prototipo

Método de solicitud

POST

Dirección de solicitud

/v1/usg/dcs/member/verification-code/verify

Protocolo de transporte

HTTPS

Parámetros de solicitud

Tabla 2 Parámetros

Parámetro

Obligatorio

Tipo

Localización

Descripción

X-Access-Token

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.

contact

String

Body

Número de teléfono o dirección de correo electrónico del usuario. El backend identifica automáticamente si se trata de un número de móvil o una dirección de correo electrónico.

Si el valor es un número de móvil, el número de móvil debe contener el código de país o región. Por ejemplo, un número de móvil en China continental es +86xxxxxxxxxxxxxxx. Este parámetro se combina con el parámetro country.

maxLength: 255

minLength: 1

country

No

String

Body

País o región a la que pertenece el número de móvil.

Valor predeterminado: chinaPR.

El valor puede incluir hasta 255 caracteres.

verificationCode

No

String

Body

Código de verificación, que debe llevarse en el escenario de verificación.

Códigos de estado

Tabla 3 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

Ninguno

Ejemplo de solicitud

POST /v1/usg/dcs/member/verification-code/verify
Connection: keep-alive
X-Access-Token: stb3te1tKXh5mDfICbiSOP0GOoqwkWEDgfB9
Content-Type: application/json
Content-Length: 68
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
    "contact": "+86136********",
    "country": "chinaPR",
    "verificationCode": "753927"
}

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: 143
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: eed03de09b96dec5643adbbb55acf674

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 -H 'content-type: application/json' -X POST -H 'X-Access-Token: stb3te1tKXh5mDfICbiSOP0GOoqwkWEDgfB9' -d '{"contact": "+86136********","country": "chinaPR","verificationCode": "753927"}' https://api.meeting.huaweicloud.com/v1/usg/dcs/member/verification-code/verify