87 lines
2.1 KiB
YAML
87 lines
2.1 KiB
YAML
tags:
|
|
- Contacts
|
|
summary: Atualiza os detalhes de um contato específico associado a um usuário.
|
|
parameters:
|
|
- in: path
|
|
name: contact_id
|
|
required: true
|
|
schema:
|
|
type: integer
|
|
description: ID do contato a ser atualizado.
|
|
|
|
- name: body
|
|
in: body
|
|
required: true
|
|
schema:
|
|
type: object
|
|
required:
|
|
- phone
|
|
- contact_type
|
|
- user_id
|
|
properties:
|
|
phone:
|
|
type: string
|
|
description: "Número de telefone do contato, apenas dígitos. (Obrigatório)"
|
|
example: "123456789"
|
|
|
|
contact_type:
|
|
type: string
|
|
description: "Tipo de contato (pessoal, comercial, emergência). (Obrigatório)"
|
|
example: "pessoal"
|
|
|
|
description:
|
|
type: string
|
|
description: "Descrição adicional do contato (opcional)."
|
|
example: "João Silva"
|
|
|
|
user_id:
|
|
type: integer
|
|
description: "ID do usuário associado ao contato. (Obrigatório)"
|
|
example: 1
|
|
|
|
responses:
|
|
200:
|
|
description: Contato atualizado com sucesso.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
message:
|
|
type: string
|
|
example: "Contato atualizado com sucesso."
|
|
|
|
400:
|
|
description: Dados inválidos ao atualizar o contato. Todos os campos obrigatórios devem ser preenchidos.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
msg:
|
|
type: string
|
|
example: "Erro ao atualizar o contato. Os campos 'phone', 'contact_type', 'description' e 'user_id' são obrigatórios."
|
|
|
|
401:
|
|
description: Token de autenticação inválido ou ausente.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
msg:
|
|
type: string
|
|
example: "Token de autenticação inválido."
|
|
|
|
404:
|
|
description: Contato não encontrado.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
msg:
|
|
type: string
|
|
example: "Contato não encontrado."
|
|
|
|
500:
|
|
description: Erro interno no servidor ao atualizar o contato.
|
|
schema:
|
|
type: object
|
|
properties:
|
|
msg:
|
|
type: string
|
|
example: "Erro interno no servidor."
|