Histórico da Página

...

Informações

title	Associação de Perfis (Roles)

Para adicionar/ e remover perfis á um usuário é necessário realizar as operações de Post/Delete nas rotas de perfis conforme abaixo

Exemplo Sucesso

Expandir

title	Víncular perfil ao usuário (Post)

Método HTTP: Post

Máscara de Url: http://{domínio}:{porta}/api/framework/v1/users/{user}/roles

Expandir

title

Informações

icon	false
title	Exemplo de Configuração

Url Utilizada: http://localhost:8051/api/framework/v1/users/apiteste/roles

Variável	Descrição	Valor
domínio	endereço do serviço de webservice	localhost
porta	porta do serviço	8051
user	código do usuário	apiteste

Expandir

title	Exemplo Sucesso

Informações

icon	false
title	Request Body

Bloco de código

language	js
title	Json
linenumbers	true

{
	"roles": [
		{
			"company": "0",
			"value": "DBA_G"
		}
	]
}

Informações

icon	false
title	Response

HttpStatus: 200

Bloco de código

language	js
title	Json
linenumbers	true

{
    "id": "apiteste",
    "roles": [
        {
            "company": "1",
            "value": "DBA_G"
        },
        {
            "company": "6",
            "value": "DBA_G"
        },
        {
            "company": "7",
            "value": "DBA_G"
        }
    ]
}

Aviso

title	Atenção

Ao enviar o codigo da coligada (Company) como 0 o sistema irá adicionar o perfil para todas as coligadas que o usuário possuir permissão.

Como no exemplo da resposta, o perfil DBA_G foi associado para as coligadas 1,6 e 7.

Expandir

title	Exemplo de Retorno (Response Error)Erro

Expandir

title	Usuário já possui algum perfil associado

Informações

icon	false
title	Request Body

Bloco de código

language	js
title	Json
linenumbers	true

{
	"roles":

[
		{
			"company": "

1

0",
			"value": "

PERFIL-1

DBA_G"
		}
	]
}

HttpStatus: 400

Informações

icon	false
title	Response

{
    "Code": "FE019",
    "Message": "Usuário APITESTE já está associado ao perfil 'CodColigada:'1'|Sistema:'G'|CodPerfil:'DBA'|IdPerfil:DBA_G'!",
    "DetailMessage": "",
    "HelpUrl": "",
    "Details": null
}

Expandir

title	Usuário sem permissão

Informações

icon	false
title	Request Body

Bloco de código

language	js
title	Json
linenumbers	true

{
	"roles": [

, { "company": "1", "value": "PERFIL-2" },

{
			"company": "

2

0",
			"value": "

PERFIL-2

DBA_S"
		}

]
}

HttpStatus: 401

Informações

icon	false
title	Response

{
    "Code": "FE005",
    "Message": "O Usuário informado não tem permissão para associar perfis na coligada 1 sistema S!",
    "DetailMessage": "",
    "HelpUrl": "",
    "Details": null
}

Expandir

title	Remover perfil do usuário (Delete)

Método HTTP: Delete

Máscara de Url: http://{domínio}:{porta}/api/framework/v1/users/{user}/roles/company/{company}/role/{role}

Informações

icon	false
title	Exemplo de Configuração

Url Utilizada: http://localhost:8051/api/framework/v1/users/apiteste/roles/company/0/role/DBA_S

Variável	Descrição	Valor
domínio	endereço do serviço de webservice	localhost
porta	porta do serviço	8051
user	código do usuário	apiteste
company	código da coligada que será utilizada	0
role	Identificador(IDPERFIL) do perfil que será atribuído	DBA_S

Informações

icon	false
title	Response (Sucesso ou Erro)

HttpStatus: 204

Response Body: Vazio

Aviso

title	Atenção

Por padrão, nas mensagens de DELETE, a resposta deve ser enviada com HTTP Code 204 (No content) e sem corpo no retorno, mesmo se não obtiver sucesso.

...

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 71

Nova versão 72

Chave