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
Método de solicitud |
POST |
---|---|
Dirección de solicitud |
/v1/usg/acs/verifycode/send |
Protocolo de transporte |
HTTPS |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Localización |
Descripción |
---|---|---|---|---|
Content-Type |
Sí |
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.
|
token |
No |
String |
Body |
Tokense ha devuelto después de verificar el CAPTCHA de la pieza del rompecabezas. |
user |
Sí |
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
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 |
---|---|---|
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.