👤 Contatos (Contacts)

Os Contatos são pessoas que já estão validadas, ou seja, fazem parte da sua carteira de clientes ou são representantes de uma Empresa (Customer).

---

Listar Contatos

Retorna uma lista paginada de contatos.

GET /api/contacts

Parâmetros de Query (Opcionais)

• page: Número da página (padrão: 1)
• pageSize: Quantidade de itens por página (padrão: 10)

Exemplo de Resposta (200 OK)

{
  "items": [
    {
      "id": "b3285f64-5717-4562-b3fc-2c963f66afa6",
      "firstName": "Carlos",
      "lastName": "Mendes",
      "email": "carlos@gmail.com",
      "phone": "41999999999",
      "title": "Gerente de TI",
      "customerId": "uuid-da-empresa",
      "createdAt": "2026-07-11T12:00:00Z"
    }
  ],
  "totalCount": 42,
  "totalPages": 5,
  "currentPage": 1
}

---

Criar um Contato

POST /api/contacts

Corpo da Requisição

{
  "firstName": "Ana",
  "lastName": "Ferreira",
  "email": "ana.ferreira@email.com",
  "phone": "31988887777",
  "title": "Diretora",
  "customerId": "uuid-da-empresa"
}

Observação: O campo customerId é opcional, mas recomendado caso queira vincular o contato a uma empresa existente.

---

Obter, Atualizar e Excluir

• Visualizar: GET /api/contacts/{id}
• Atualizar: PUT /api/contacts/{id}
• Excluir: DELETE /api/contacts/{id}