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.

Nesta página

Descrição
Depuração
Protótipo
Parâmetros de solicitação
Códigos de status
Parâmetros de resposta
Exemplo de solicitação
Exemplo de resposta
Códigos de erro
Exemplo de comando cURL

Mostrar todos

Central de ajuda/ Meeting/ Referência de API do servidor/ Gerenciamento de departamento/ APIs/ Adição de um departamento

Adição de um departamento

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

Ver PDF

Descrição

Esta API é usada por um administrador empresarial para adicionar um departamento. Até 10 níveis de departamentos com até 100 subdepartamentos em cada nível podem ser adicionados. Por padrão, uma empresa pode ter até 10.000 departamentos.

SLA

Taxa de sucesso de solicitação: > 99,99%

Atraso na solicitação TP99: 70 ms

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/dept
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.
deptCode	Não	String	Corpo	Código de departamento único na empresa. Se este parâmetro é transportado, o valor real é usado e não pode ser alterado. O valor pode conter até 32 caracteres.
deptName	Sim	String	Corpo	Nome do departamento. maxLength: 128 minLength: 1
parentDeptCode	Não	String	Corpo	Código do departamento de pais. O valor padrão é o código do departamento raiz. Valor padrão: 1. O valor pode conter até 32 caracteres.
note	Não	String	Corpo	Observações. maxLength: 96 minLength: 0
inPermission	Não	String	Corpo	Permissões de usuários em outros departamentos para acessar detalhes de usos neste departamento. UNLIMITED: não restrito. Este é o valor padrão. OPEN: detalhes de usuários neste departamento são acessíveis a outros departamentos (independentemente das configurações de permissão de outros).
outPermission	Não	String	Corpo	Permissões de usuários neste departamento para acessar detalhes de usos em outros departamentos. UNLIMITED: não restrito. ONLY_SELF: os usuários deste departamento só podem consultar detalhes sobre si mesmos. SELF_AND_CHILD_DEPARTMENT: os usuários do departamento podem consultar detalhes do departamento e seus subdepartamentos. DESIGNATED_DEPARTMENT: os usuários deste departamento podem consultar detalhes de departamentos específicos.
designatedOutDeptCodes	Não	Array of strings	Corpo	Lista de departamentos que podem ser acessados. Este parâmetro é válido somente quando outPermission é definido como DESIGNATED_DEPARTMENT. Até 150 departamentos podem ser configurados.
sortLevel	Não	Integer	Corpo	Número de sequência do departamento. Um departamento com um número de sequência menor é exibido primeiro. Mínimo: 1 Máximo: 10000

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 é executada ou falha.
403	Permissões insuficientes.
500	Exceção do servidor.

Parâmetros de resposta

**Tabela 4** Parâmetros de resposta
Parâmetro	Tipo	Descrição
value	String	Código do departamento.

Exemplo de solicitação

POST /v1/usg/dcs/corp/dept
Connection: keep-alive
X-Access-Token: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki
Content-Type: application/json
Content-Length: 31
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)
     
{
    "deptName": "test999"
}

Exemplo de resposta

HTTP/1.1 200 
Date: Tue, 17 Dec 2019 09:32:47 GMT
Content-Type: application/json;charset=UTF-8
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 539e8b710378987ffc5eb844b5e5c290

{
    "value": "s4f"
}

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: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki' -d '{"deptName": "test999"}' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/dept

Tópico principal: APIs

Tópico anterior: APIs

Próximo tópico: Modificação de um departamento

Feedback

Esta página foi útil?

Sim Não

Deixar um comentário

Obrigado por seus comentários. Estamos trabalhando para melhorar a documentação.

O sistema está ocupado. Tente novamente mais tarde.

Quais dos seguintes problemas você encontrou?

O conteúdo é inconsistente com a UI do produto

Descrições pouco claras

Falta de exemplos ou código

Passos incorretos

Não encontro o que preciso

Falta de melhores práticas

Feedback (opcional)

0/500

Selecione pelo menos um tipo de problema e insira seus comentários ou sugestões.

Insira um máximo de 500 caracteres.

Enviar Cancelar