Criar usuário #

Cria um novo usuário atribuído a um locatário Cliente.

POST /v1.0/clientes/{CUSTOMER_TENANT_ID}/usuários

Observações #

Sempre que um novo usuário for criado, ele receberá a função "customer.user" que permite que ele faça login no Portal do cliente. Isso também enviará um e-mail de ativação para o endereço fornecido assim que o Usuário é criado.

Exemplo #

Esta solicitação criará um novo usuário com os seguintes detalhes:

Cliente: dentro do locatário do cliente com a ID de {CUSTOMER_TENANT_ID}
E-mail: [email protected]
Nome de exibição: "Novo usuário",
Papéis:
- Administrador de usuários (admin.user)
- Usuário do site (customer.user)
- Nível de supervisor do repórter (customer.user.supervisorl1)
- Configurações do cliente (customer.settings)

Pedir #

POST [https://api.na.myreports.cloud/api/v1.0/customers/{CUSTOMER_TENANT_ID}/usuários](https://api.na.myreports.cloud/api/v1.0/customers/{CUSTOMER_TENANT_ID}/users) HTTP/1.1
Tipo de conteúdo: application/json
aceitar-encargos: verdadeiro
Autorização: Portador {TOKEN}
Conexão: keep-alive
{
	"e-mail": "[[email protected]](mailto:[email protected])",
	"displayName": "Novo usuário",
	"papéis": [" admin.user", "customer.user", "customer.user.supervisorl1", "customer.settings"]["admin.user", "customer.user", "customer.user.supervisorl1", "customer.settings"]
}

Resposta #

HTTP/1.1 201 Criado
Tipo de conteúdo: aplicativo / json; conjunto de caracteres=utf-8
Comprimento do conteúdo: xx
Localização: <https://api.na.myreports.cloud/api/v1.0/customers/{CUSTOMER_TENANT_ID}/users/{USER_ID}>
{
	"dados": {
		"id": "{USER_ID}",
		"displayName": "Novo usuário",
		"e-mail": "[[email protected]](mailto:[email protected])",
		"primaryTenant": "{CUSTOMER_TENANT_ID}",
		"papéis": [" admin.user", "customer.user", "customer.user.supervisorl1", "customer.settings"]["admin.user", "customer.user", "customer.user.supervisorl1", "customer.settings"]
	},
	"status": "sucesso",
	"carimbo de data/hora": "2019-11-29T16:03:23.9251680Z"
}

Erros #

Desautorizado #

Quando o token não é fornecido, é inválido ou expirado

HTTP/1.1 401 Não autorizado

Solicitação incorreta #

Quando a ID do locatário fornecida não está no formato correto

HTTP/1.1 400 Solicitação incorreta
Data: Qui, 06 de fevereiro de 2020 12:45:27 GMT
Tipo de conteúdo: aplicativo / json; conjunto de caracteres=utf-8
Comprimento do conteúdo: 149
{
	"erro": 400,
	"message": "O valor '<tenant id>' não é válido.",
	"status": "erro",
	"carimbo de data/hora": "2020-02-06T12:45:27.5903465Z"
}

Quando a quantidade de licenças de usuário for excedida

HTTP/1.1 400 Solicitação incorreta
Data: Qui, 06 de fevereiro de 2020 12:45:27 GMT
Tipo de conteúdo: aplicativo / json; conjunto de caracteres=utf-8
Comprimento do conteúdo: 149
{
	"erro": 400,
	"message": "Não há licenças de usuário suficientes disponíveis.",
	"status": "erro",
	"carimbo de data/hora": "2020-02-06T12:45:27.5903465Z"
}

Não encontrado #

Quando não há clientes que tenham uma ID de locatário correspondente

HTTP/1.1 404 Não encontrado
Data: Qui, 06 de fevereiro de 2020 12:46:58 GMT
Tipo de conteúdo: aplicativo / json; conjunto de caracteres=utf-8
Comprimento do conteúdo: 95
{
	"erro": 404,
	"message": "Não encontrado",
	"status": "erro",
	"carimbo de data/hora": "2020-02-06T12:46:58.7669535Z"
}

Pagamento Obrigatório #

Se essa solicitação puder incorrer em cobranças adicionais, consulte Encargos.

HTTP/1.1 402 Pagamento necessário
Data: Qui, 06 de fevereiro de 2020 13:01:00 GMT
Tipo de conteúdo: aplicativo / json; conjunto de caracteres=utf-8
Comprimento do conteúdo: 274
{
	"dados": {
		"id": "{USER_ID}",
		"displayName": "Novo usuário",
		"e-mail": "[[email protected]](mailto:[email protected])",
		"primaryTenant": "{CUSTOMER_TENANT_ID}",
		"papéis": [" admin.user", "customer.user", "customer.user.supervisorl1", "customer.settings"]["admin.user", "customer.user", "customer.user.supervisorl1", "customer.settings"]
	},
	"erro": 402,
	"message": "aplicam-se custos adicionais",
	"status": "erro",
	"carimbo de data/hora": "2020-02-06T13:01:01.1302340Z"
}

Conflito #

Se o endereço de email desse novo usuário já for existente para outro usuário nesse locatário do cliente

HTTP/1.1 409 Conflito
Data: Qui, 06 de fevereiro de 2020 13:05:39 GMT
Tipo de conteúdo: aplicativo / json; conjunto de caracteres=utf-8
Comprimento do conteúdo: 178
{
	"erro": 409,
	"errorCode": "Conflito de e-mail",
	"message": "Um usuário com o endereço de e-mail [[email protected]](mailto:[email protected]) já existe.",
	"status": "erro",
	"carimbo de data/hora": "2020-02-06T13:05:39.5486342Z"
}