Adição de um departamento
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
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
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.
|
outPermission |
Não |
String |
Corpo |
Permissões de usuários neste departamento para acessar detalhes de usos em outros departamentos.
|
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
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 |
---|---|---|
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