Skip to main content

GET Listar Permissões da Role

Lista as permissões atribuídas a uma role da clínica.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige a permissão update_roles.

Inclui permissões fora do catálogo

A lista traz todas as permissões da role, inclusive as aposentadas (nome terminado em _removed), que o editor não oferece.


Endpoint​

GET https://api-dev.imagemais.com.br/api/roles/{slug}/permissions

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
slugstring✅Identificador da role na clínica, como devolvido em slug (ex.: org-recepcao). Apenas letras, números, _ e -

Requisição​

curl -X 'GET' \n 'https://api-dev.imagemais.com.br/api/roles/org-recepcao/permissions' \n -H 'accept: application/json' \n -H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

[
{
"permission_name": "read_patients"
},
{
"permission_name": "create_patients"
}
]

400 Slug inválido​

{
"message": "Role inválida",
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}

404 Role não encontrada​

{
"message": "Role não encontrada",
"error": "Not Found",
"statusCode": 404
}

503 Serviço de login indisponível​

{
"message": "Não foi possível falar com o serviço de login. Tente novamente em instantes.",
"error": "Service Unavailable",
"statusCode": 503
}