Envio de um código de verificação
Descrição
Esta API é usada para enviar um código de verificação. Um usuário solicita a obtenção de um código de verificação depois de passar a verificação da peça do quebra-cabeça CAPTCHA na GUI. Depois de receber uma solicitação, o servidor envia um código de verificação para o endereço de e-mail ou número de celular.
Depuração
Você pode depurar essa API no API Explorer.
Protótipo
|
Método de solicitação |
POST |
|---|---|
|
Endereço de solicitação |
/v1/usg/acs/verifycode/send |
|
Protocolo de transporte |
HTTPS |
Parâmetros de solicitação
|
Parâmetro |
Obrigatório |
Tipo |
Localização |
Descrição |
|---|---|---|---|---|
|
Content-Type |
Sim |
String |
Cabeçalho |
Formato de mídia do corpo. Exemplo: application/json; charset=UTF-8 |
|
X-Request-Id |
Não |
String |
Cabeçalho |
ID da solicitação, que é usado para rastreamento e localização de falhas. É aconselhável usar um UUID. Se este parâmetro não for transportado, um ID de solicitação é gerado automaticamente. |
|
Accept-Language |
Não |
String |
Cabeçalho |
Idioma. Valores: zh-CN para chinês (padrão) e en-US para inglês. |
|
sendMethod |
Não |
String |
Corpo |
Modo de envio do código de verificação. Esse parâmetro é obrigatório quando o tipo de usuário é uma conta de usuário real. O valor padrão é sms.
|
|
token |
Não |
String |
Corpo |
Token retornado depois que a peça do quebra-cabeça CAPTCHA é verificada. |
|
user |
Sim |
String |
Corpo |
Informações de identidade do usuário (número de celular, endereço de e-mail ou conta de usuário). O valor deve ser o mesmo que as informações de identidade do usuário contidas na solicitação de envio da peça do quebra-cabeça CAPTCHA. maxLength: 255 minLength: 1 |
Códigos de status
|
Código de status HTTP |
Descrição |
|---|---|
|
200 |
Operação bem-sucedida. |
|
400 |
Parâmetros inválidos. |
|
401 |
A autenticação não é executada ou falha. |
|
403 |
Permissões insuficientes. |
|
500 |
Exceção do servidor. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
bindEmail |
String |
Se o código de verificação for enviado para um endereço de e-mail, defina esse parâmetro como o endereço de e-mail vinculado ao usuário. (O endereço de e-mail é processado para mascarar alguns caracteres do meio, por exemplo, tes****ount@huawei.com.) |
|
bindPhone |
String |
Se um código de verificação for enviado para um número de celular, defina esse parâmetro como o número de celular vinculado ao usuário. (O número de celular é processado para mascarar alguns caracteres do meio, por exemplo, +8618****12345.) |
|
expire |
Integer |
Período de validade, em segundos. |
Exemplo de solicitação
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********"
}
Exemplo de resposta
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 erro
Se um código de erro começando com MMC ou USG for retornado quando você usar essa API, corrija a falha seguindo as instruções fornecidas no Centro de erros da API da Huawei Cloud.
