Obtención de un código de verificación
Descripción
Esta API es utilizada por un usuario de empresa para obtener un código de verificación para cambiar el número de teléfono móvil o la dirección de correo electrónico. Después de llamar a esta API, el sistema envía el código de verificación al número de teléfono móvil o dirección de correo electrónico del usuario. El código de verificación es válido en un minuto.
SLA
Tasa de éxito de solicitudes: > 99.99%
Retardo de solicitud TP99: 125 ms
Depuración
Puede depurar esta API en el Explorador de API.
Prototipo
Método de solicitud |
POST |
---|---|
Dirección de solicitud |
/v1/usg/dcs/member/verification-code |
Protocolo de transporte |
HTTPS |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Localización |
Descripción |
---|---|---|---|---|
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 el chino (predeterminado) y en-US para el inglés. |
contact |
Sí |
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 teléfono 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 contener 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
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
Ninguno
Solicitud de ejemplo
POST /v1/usg/dcs/member/verification-code Connection: keep-alive X-Access-Token: stbmRCbnRpo5IVy9SiOMVVogwnm5iIccjYho Content-Type: application/json Content-Length: 35 Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) { "contact": "+86136********", "country": "chinaPR" }
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: 8b080717d1868035cfa16b10a92bea95
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 el 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: stbmRCbnRpo5IVy9SiOMVVogwnm5iIccjYho' -d '{"contact": "+86136********","country": "chinaPR",}' https://api.meeting.huaweicloud.com/v1/usg/dcs/member/verification-code