Obtenção de um código de verificação
Descrição
Esta API é usada por um usuário empresarial para obter um código de verificação para alterar o número de celular ou o endereço de e-mail. Depois que essa API é chamada, o sistema envia o código de verificação para o número de celular ou endereço de e-mail do usuário. O código de verificação é válido dentro de um minuto.
SLA
Taxa de sucesso de solicitação: > 99,99%
Atraso na solicitação TP99: 125 ms
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/dcs/member/verification-code |
Protocolo de transporte |
HTTPS |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Localização |
Descrição |
---|---|---|---|---|
X-Access-Token |
Sim |
String |
Cabeçalho |
Token de autorização. Use o valor de accessToken na resposta à solicitação de Autenticação de um ID de aplicação. |
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. |
contact |
Sim |
String |
Corpo |
Número de telemóvel ou endereço de e-mail do usuário. O back-end identifica automaticamente se é um número de celular ou um endereço de e-mail. Se o valor for um número de celular, o número de celular deverá conter o código de país ou região. Por exemplo, um número de celular na China continental é +86xxxxxxxxxxxxxxx. Este parâmetro é combinado com o parâmetro country. maxLength: 255 minLength: 1 |
country |
Não |
String |
Corpo |
País ou região a que o número de telemóvel pertence. Valor padrão: chinaPR. O valor pode conter até 255 caracteres. |
verificationCode |
Não |
String |
Corpo |
Código de verificação, que deve ser transportado no cenário de verificação. |
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
Nenhum
Exemplo de solicitação
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" }
Exemplo de resposta
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 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.
Exemplo 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