/especialidades/{id}:
get:
summary: Recupera uma entidade pelo ID
parameters:
- name: id
in: path
required: true
schema:
type: integer
responses:
200:
description: Sucesso
content:
application/json:
schema:
type: object
properties:
id:
type: integer
descricao:
type: string
404:
description: Especialidade não encontrada!
content:
application/json:
example: "Not Found"
put:
summary: Atualiza uma entidade pelo ID
parameters:
- name: id
in: path
required: true
schema:
type: integer
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
descricao:
type: string
responses:
200:
description: Entidade atualizada com sucesso
content:
application/json:
schema:
type: object
properties:
id:
type: integer
descricao:
type: string
400:
description: Requisição inválida
content:
application/json:
example: "Bad Request"
404:
description: Especialidade não encontrada!
content:
application/json:
example: "Not Found"
delete:
summary: Remove uma entidade pelo ID
parameters:
- name: id
in: path
required: true
schema:
type: integer
responses:
204:
description: Entidade removida com sucesso (No Content)
404:
description: Especialidade não encontrada!
content:
application/json:
example: "Not Found"