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.

Central de ajuda/ Meeting/ Referência de API do servidor/ Enterprise Management/ APIs/ Criação de uma empresa como um administrador de SP

Atualizado em 2023-08-02 GMT+08:00

Ver PDF

Criação de uma empresa como um administrador de SP

Descrição

Esta API é usada para criar uma empresa, atribuir o administrador empresarial padrão e alocar recursos à empresa como um administrador de SP.

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/sp/corp
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.
adminInfo	Sim	AdminDTO object	Corpo	Detalhes do administrador.
basicInfo	Sim	CorpBasicDTO object	Corpo	Detalhes básicos da empresa.
groupId	Não	String	Corpo	Ingestão de mídia (incluindo SBC e MCU) ID do grupo, que pode ser obtido através da API para Consulta de informações de recursos como administrador do SP.
propertyInfo	Não	Array of OrgPropertyDTO objects	Corpo	Informações sobre itens configuráveis.
resInfo	Não	AddCorpResDTO object	Corpo	Detalhes do recurso empresarial.

**Tabela 3** Estrutura de dados AdminDTO
Parâmetro	Obrigatório	Tipo	Localização	Descrição
account	Sim	String	Corpo	Conta de administrador. O valor pode conter letras, números, hifens (_), pontos (.) e sinais de arroba (@) e não pode conter apenas números. O sinal de arroba (@) não pode ser seguido por um ponto (.).
country	Não	String	Corpo	País ou região a que o número de telemóvel pertence.
email	Não	String	Corpo	Endereço de e-mail do administrador. O número de celular ou endereço de e-mail do administrador deve ser especificado. Caso contrário, a senha do administrador não poderá ser redefinida posteriormente. Se a empresa não ativar as notificações por SMS, o endereço de e-mail será obrigatório. O formato é (^$\|^[\w-+]+(\.[\w-+]+)@[\w-]+(\.[\w-]+)(\.[\w-]{1,})$).
name	Sim	String	Corpo	Nome do administrador.
phone	Não	String	Corpo	Número de celular. O número de celular deve conter o código do país, por exemplo, um número de celular na China continental é +86xxxxxxxx. Este parâmetro é combinado com o parâmetro country. O número de celular é no formato de (^$\|^[+]?[0-9]+$).
pwd	Sim	String	Corpo	Se este parâmetro é transportado, o valor real é usado. Caso contrário, o valor é gerado pelo back-end por padrão. A senha deve atender aos seguintes requisitos: A senha contém de 6 a 32 caracteres. A senha não pode ser a mesma que a conta ou a conta soletrada para trás. A senha deve conter pelo menos dois dos seguintes: letras minúsculas, letras maiúsculas, números e caracteres especiais (`~!@#$%^&*()-_=+\\|[{}];:",'<.>/?).

**Tabela 4** Estrutura de dados CorpBasicDTO
Parâmetro	Obrigatório	Tipo	Localização	Descrição
address	Não	String	Corpo	Endereço.
country	Não	String	Corpo	País ou região a que o número de telemóvel pertence.
description	Não	String	Corpo	Observações.
domain	Não	String	Corpo	Nome de domínio empresarial.
email	Não	String	Corpo	Endereço de e-mail, no formato de (^$\|^[\w-+]+(.[\w-+]+)@[\w-]+(.[\w-]+)(.[\w-]{1,})$).
fax	Não	String	Corpo	Número de fax, em formato de ^$\|^[+]?[0-9]+$.
language	Não	String	Corpo	Linguagem de voz. Opções: zh-CN e en-US.
name	Sim	String	Corpo	Designação da empresa, no formato de ^[^#%&'+;<>="'??\....../]*$.
phone	Não	String	Corpo	Número de celular. O número de celular deve conter o código do país, por exemplo, um número de celular na China continental é +86xxxxxxxx. Este parâmetro é combinado com o parâmetro country. O número de celular é no formato de (^$\|^[+]?[0-9]+$).
spId	Não	String	Corpo	Este parâmetro é retornado somente durante a consulta.
timeZoneId	Não	String	Corpo	ID de fuso horário. Por exemplo, o timeZoneId de Pequim GMT+08:00 é 56. Para o mapeamento entre IDs de fuso horário e fusos horários, consulte Tabela de fuso horário.

**Tabela 5** Estrutura de dados AddCorpResDTO
Parâmetro	Obrigatório	Tipo	Localização	Descrição
resource	Não	Array of ResourceDTO objects	Corpo	Lista de recursos a serem adicionados à empresa.

**Tabela 6** Estrutura de dados OrgPropertyDTO
Parâmetro	Obrigatório	Tipo	Localização	Descrição
propertyKey	Não	String	Corpo	Chave do item de configuração. Para ativar a gravação local, defina este parâmetro para enableClientRecord.
propertyValue	Não	String	Corpo	Valor do item de configuração. Para ativar a gravação local, defina este parâmetro como true.

**Tabela 7** Estrutura de dados ResourceDTO
Parâmetro	Obrigatório	Tipo	Localização	Descrição
id	Não	String	Corpo	ID do recurso. Se este parâmetro não for passado, o valor é gerado automaticamente.
count	Sim	Integer	Corpo	Quantidade de recursos.
expireDate	Sim	Long	Corpo	Hora UTC quando o recurso expira.
type	Sim	String	Corpo	Tipo de recurso. VMR: sala de reunião na nuvem. CONF_CALL: participante concorrente. HARD_1080P: conta de acesso ao terminal físico de 1080p. HARD_720P: conta de acesso ao terminal físico de 720p. SOFT: conta de usuário. ROOM: conta de quadro branco. LIVE: porta de transmissão ao vivo. RECORD: espaço de armazenamento de gravação. HARD_THIRD_PARTY: conta de acesso de terminal físico de terceiros. HUAWEI_VISION: conta de TV inteligente. IDEA_HUB - ideahub
typeId	Não	String	Corpo	ID do tipo de recurso. Por exemplo, as salas de reunião na nuvem podem ser divididas em salas de reunião na nuvem com 5 e 10 participantes. Nesse caso, o tipo de recurso é sala de reunião na nuvem e typeId é vmrPkgId. vmrPkgId é usado para distinguir os seguintes subtipos de recursos: vmr10:ff808081699b56d40169c410d5080179 vmr50:ff808081699b56cb0169c411a0980152 vmr100:ff808081699b56cb0169c41167850151 vmr200:ff808081699b56d40169c410913d0178 vmr25:ff808081699b56d40169c4111fe5017a vmr300:ff8080816b9ec3ab016bdff237962e83 vmr400:ff8080816b9ec475016bdff37efc279f vmr500:ff8080816b9ec3ab016bdff338542e84

Códigos de status

**Tabela 8** 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

**Tabela 9** Parâmetros de resposta
Parâmetro	Tipo	Descrição
value	String	Resposta.

Exemplo de solicitação

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

{
    "adminInfo": {
        "account": "zhangsan@corp",
        "country": "chinaPR",
        "email": "zhangsan@huawei.com",
        "name": "zhangsan",
        "phone": "+86191****9092",
        "pwd": "cnp200@HW"
    },
    "basicInfo": {
        "address": "Hangzhou, Zhejiang",
        "country": "chinaPR",
        "description": "description",
        "domain": "huawei.com",
        "email": "zhangsan@huawei.com",
        "fax": "+123456789",
        "language": "zh-CN",
        "name": "Huawei Technologies Co., Ltd.",
        "phone": "+86191****9092",
        "spId": "",
        "timeZoneId": "56"
    },
    "groupId": "297e87ec7713734b01771458c2d80000",
    "resInfo": {
        "resource": [
            {
                "count": 10,
                "expireDate": 2549030400000,
                "id": "36f2c0117cf14c3db61a7880eb73cee6",
                "type": "VMR",
                "typeId": "2c90bb2871e577590171e57bfec908b2"
            }
        ]
    }
}

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: 21
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 43689056504b4ff22663262d44e141aa

{
  "value": "818803911"
}

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: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF' -d '{"account": "zhangsan@corp","country": "chinaPR","email": "zhangsan@huawei.com","name": "zhangsan","phone": "+86191****9092","pwd": "cnp200@HW","sendNotify": false},"basicInfo": {"address": "Hangzhou Zhejiang","country": "chinaPR","description": "description","domain": "huawei.com","email": "zhangsan@huawei.com","fax": "+123456789","language": "zh-CN","name": "Huawei Technologies Co., Ltd.","phone": "+86191****9092","spId": "","timeZoneId": "56"},"groupId": "297e87ec7713734b01771458c2d80000","resInfo": {"resource": [{"count": 10,"expireDate": 2549030400000,"id": "36f2c0117cf14c3db61a7880eb73cee6","type": "VMR","typeId": "2c90bb2871e577590171e57bfec908b2"}]}}' https://api.meeting.huaweicloud.com/v1/usg/dcs/sp/corp

Tópico principal: APIs

Tópico anterior: Consulta de pedidos de recursos empresariais por página

Próximo tópico: Exclusão de uma empresa como um administrador de SP