Saltar para o conteúdo
Referência da API
/
/
/
Adicionar grupo

Adicionar grupo

Request

Cria um grupo de perfis.

  • Pré-requisitos: o nome não pode estar vazio, admite no máximo 100 caracteres e não pode já estar em uso por um grupo da equipe. Uma equipe é limitada a 1000 grupos.
  • Efeito: cria o grupo. Quando a equipe autoriza o acesso por grupo e quem chama não é o proprietário, o acesso ao novo grupo também é concedido a quem chama.
  • Conclusão: sincrônica; data traz o identificador do novo grupo.
  • Nova tentativa: um nome duplicado é rejeitado em vez de reutilizar o grupo existente, então uma repetição depois de uma chamada que teve sucesso mas cuja resposta você não viu falha com um erro de nome duplicado; isso é sinal de que a primeira chamada funcionou. Confirme com /envgroup/page.
Bodyapplication/json
groupNamestringrequired

Nome do grupo

POST
/api/envgroup/create
curl -i -X POST \
  http://127.0.0.1:40000/api/envgroup/create \
  -H 'Content-Type: application/json' \
  -d '{
    "groupName": "Group-333"
  }'

Responses

Sucesso. data é um objeto com os campos id e groupName.

Headers
any
Bodyapplication/json
codeintegerrequired

Código de resultado retornado: 0: Normal. Outros códigos são exceções.

msgstring or nullrequired

Mensagem de erro

dataobjectrequired

Os dados retornados pela operação

requestIdstringrequired

ID da solicitação de operação

Response
{
  "code": 0,
  "msg": null,
  "data": {
    "id": "1673823102599682",
    "groupName": "example-name"
  },
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d"
}