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

Envío de un código de verificación

Descripción

Esta API se utiliza para enviar un código de verificación. Un usuario solicita obtener un código de verificación después de pasar la verificación de la pieza de rompecabezas CAPTCHA en la GUI. Después de recibir una solicitud, el servidor envía un código de verificación a la dirección de correo electrónico o número de móvil.

Depuración

Puede depurar esta API en API Explorer.

Prototipo

Tabla 1 Prototipo

Método de solicitud

POST

Dirección de solicitud

/v1/usg/acs/verifycode/send

Protocolo de transporte

HTTPS

Parámetros de solicitud

Tabla 2 Parámetros

Parámetro

Obligatorio

Tipo

Localización

Descripción

Content-Type

String

Header

Formato de los medios de comunicación del cuerpo.

Ejemplo: application/json; charset=UTF-8

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.

sendMethod

No

String

Body

Modo para enviar el código de verificación.

Este parámetro es obligatorio cuando el tipo de usuario es una cuenta de usuario real. El valor predeterminado es sms.

  • sms: modo de SMS.
  • email: modo de correo electrónico.

token

No

String

Body

Tokense ha devuelto después de verificar el CAPTCHA de la pieza del rompecabezas.

user

String

Body

Información de identidad del usuario (número de teléfono móvil, dirección de correo electrónico o cuenta de usuario).

El valor debe ser el mismo que la información de identidad de usuario contenida en la solicitud de envío de la pieza del rompecabezas CAPTCHA.

maxLength: 255

minLength: 1

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

Tabla 4 Parámetros de respuesta

Parámetro

Tipo

Descripción

bindEmail

String

Si el código de verificación se envía a una dirección de correo electrónico, establezca este parámetro en la dirección de correo electrónico vinculada al usuario. (La dirección de correo electrónico se procesa para enmascarar algunos caracteres centrales, por ejemplo, tes****ount@huawei.com.)

bindPhone

String

Si se envía un código de verificación a un número de móvil, ajuste este parámetro al número de móvil vinculado al usuario. (El número de móvil se procesa para enmascarar algunos caracteres del medio, por ejemplo, +8618****12345.)

expire

Integer

Período de validez, en segundos.

Ejemplo de solicitud

POST /v1/usg/acs/verifycode/send
Connection: keep-alive 
Content-Type: application/json 
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) 

{
    "token": "R7PE9vsaEUHjiLsraWTF3WQhmBet16SbI",
    "user": "+86136********"
}

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 
http_proxy_id: c94f64967745b0670c299c0688479078 

{
    "expire":180,
    "bindPhone":"+8618*********",
    "bindEmail":null
}

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.