67 lines
1.8 KiB
YAML
67 lines
1.8 KiB
YAML
tags:
|
|
- Permissions
|
|
summary: "Lista todas as permissões com paginação e opção de filtragem."
|
|
parameters:
|
|
- in: query
|
|
name: page
|
|
schema:
|
|
type: integer
|
|
default: 1
|
|
description: "Número da página. Default: 1."
|
|
- in: query
|
|
name: per_page
|
|
schema:
|
|
type: integer
|
|
default: 10
|
|
description: "Quantidade de itens por página. Default: 10."
|
|
- in: query
|
|
name: permission_id
|
|
schema:
|
|
type: integer
|
|
description: "ID da permissão para filtrar no retorno."
|
|
responses:
|
|
200:
|
|
description: "Lista das permissões encontrada com sucesso."
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
permissions:
|
|
type: array
|
|
items:
|
|
type: object
|
|
properties:
|
|
id:
|
|
type: integer
|
|
description: "ID da permissão."
|
|
example: 1
|
|
name:
|
|
type: string
|
|
description: "Nome da permissão."
|
|
example: "Permissão de Admin"
|
|
description:
|
|
type: string
|
|
description: "Descrição da permissão."
|
|
example: "Permissão completa para gerenciar o sistema."
|
|
404:
|
|
description: "Nenhuma permissão encontrada."
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
msg:
|
|
type: string
|
|
example: "Nenhuma permissão encontrada."
|
|
401:
|
|
description: "Token de autenticação inválido ou ausente."
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
msg:
|
|
type: string
|
|
example: "Token de autenticação inválido ou ausente."
|