Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Informações
titleAssociaçã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

Expandir
titleAdicionar Víncular perfil ao usuário (Post)
de Retorno (Response Error)
Informações
iconfalse

Método HTTP: Post

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

Expandir
titleExemplo Sucesso


Informações
iconfalse
titleExemplo de Configuração

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

VariávelDescriçãoValor
domínioendereço do serviço de webservicelocalhost
portaporta do serviço8051
usercódigo do usuárioapiteste
Expandir
titleExemplo Sucesso
Informações
iconfalse
titleRequest Body
Bloco de código
languagejs
titleJson
linenumberstrue
{
	"roles": [
		{
			"company": "0",
			"value": "DBA_G"
		}
	]
}
Informações
iconfalse
titleResponse

HttpStatus: 200

Bloco de código
languagejs
titleJson
linenumberstrue
{
    "id": "apiteste",
    "roles": [
        {
            "company": "1",
            "value": "DBA_G"
        },
        {
            "company": "6",
            "value": "DBA_G"
        },
        {
            "company": "7",
            "value": "DBA_G"
        }
    ]
}
Aviso
titleAtençã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
titleExemplo
Erro
Expandir
titleUsuário já possui algum perfil associado
Informações
iconfalse
titleRequest Body
Bloco de código
languagejs
titleJson
linenumberstrue
{
	"roles": 
[
		{
			"company": "
1
0",
			"value": "
PERFIL-1
DBA_G"
		}
, { "company": "1", "value": "PERFIL-2" },

	]
}

HttpStatus: 400

Informações
iconfalse
titleResponse

{
    "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
titleUsuário sem permissão
Informações
iconfalse
titleRequest Body
Bloco de código
languagejs
titleJson
linenumberstrue
{
	"roles": [
		{
			"company": "
2
0",
			"value": "
PERFIL-2
DBA_S"
		}
 

	]
}

HttpStatus: 401

Informações
iconfalse
titleResponse

{
    "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
titleRemover perfil do usuário (Delete)
Informações
iconfalse

Método HTTP: Delete

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

Informações
iconfalse
titleExemplo de Configuração

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

VariávelDescriçãoValor
domínioendereço do serviço de webservicelocalhost
portaporta do serviço8051
usercódigo do usuárioapiteste
companycódigo da coligada que será utilizada0
roleIdentificador(IDPERFIL) do perfil que será atribuído

DBA_S

Informações
iconfalse
titleResponse (Sucesso ou Erro)

HttpStatus: 204

Response Body: Vazio 

Aviso
titleAtençã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.