Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Atualizado em 2023-08-02 GMT+08:00

Convite de um usuário

Descrição

Esta API é usada para convidar um usuário a ingressar em uma empresa usando o número de celular ou o endereço de e-mail.

  • Se o usuário convidado não existir no sistema do Huawei Cloud Meeting:
    • O usuário precisa se registrar no Huawei Cloud Meeting para ingressar na empresa que usa a edição gratuita ou padrão.
    • O usuário é adicionado diretamente à empresa que usa a edição premium. O usuário recebe a senha inicial da conta do Huawei Cloud Meeting e precisa alterar a senha ao fazer logon no Huawei Cloud Meeting usando o número de celular ou endereço de e-mail.
  • Se o usuário convidado existir no sistema do Huawei Cloud Meeting, o usuário receberá uma mensagem SMS ou e-mail para confirmação. Depois de aceitar o convite, o usuário é adicionado à empresa. A senha da conta de usuário permanece inalterada.

Depuração

Você pode depurar essa API no API Explorer.

Protótipo

Tabela 1 Protótipo

Método de solicitação

POST

Endereço de solicitação

/v1/usg/dcs/corp/member/add

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

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

O fundo identifica automaticamente se o número de celular ou endereço de e-mail é usado. Se o número de telemóvel for utilizado, o número de telemóvel tem de corresponder ao código do país/região.

Observação:

as empresas do site da China continental podem convidar usuários especificando endereços de e-mail ou números de celular dos usuários. Somente números de telemóvel que começam com +86 são suportados.

As empresas no site internacional podem convidar usuários apenas especificando os endereços de e-mail dos usuários.

country

Não

String

Corpo

País ou região a que o número de telemóvel pertence.

Valor padrão: chinaPR.

maxLength: 255

minLength: 0

deptCode

Não

String

Corpo

ID do departamento. Se este parâmetro não for transportado, o departamento raiz é usado por padrão.

desc

Não

String

Corpo

Observações.

maxLength: 128

minLength: 0

name

Sim

String

Corpo

Nome do usuário.

sortLevel

Não

Integer

Corpo

Número de sequência no diretório empresarial. Um valor menor indica uma posição mais alta no diretório empresarial.

title

Não

String

Corpo

Título do trabalho.

Códigos de status

Tabela 3 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 é realizada ou falha.

403

Permissões insuficientes.

500

Exceção do servidor.

Parâmetros de resposta

Nenhum

Exemplo de solicitação

POST /v1/usg/dcs/corp/member/add
Connection: keep-alive
Content-Type: application/json
X-Access-Token: stb7PzruAmA6d3JJD578jlAHczGfN4SIaup9
Content-Length: 173
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
    "contact": "+8617379679094",
    "country": "chinaPR",
    "name": "Tom"
}

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
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Server: api-gateway
X-Request-Id: ebbb9b1e50d1ec63b78d8484d170173f

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: stb7PzruAmA6d3JJD578jlAHczGfN4SIaup9' -d '{"contact": "+8617379679094","country": "chinaPR","name": "Tom"}' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/member