sass-imobiliaria/.specify/features/006-client-area/contracts/me-visits.md

1.3 KiB

Contract: GET /api/v1/me/visits

Blueprint: client_bp Auth: JWT Bearer — require_auth — ClientUser only


Request

GET /api/v1/me/visits
Authorization: Bearer <jwt_token>

Sem parâmetros de query ou corpo.


Response 200 OK

[
  {
    "id": "b3fc85f6-1234-4562-b3fc-2c963f66af11",
    "property": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "title": "Apartamento 3 quartos Jardins",
      "slug": "apartamento-3-quartos-jardins"
    },
    "message": "Gostaria de visitar no final de semana.",
    "status": "pending",
    "scheduled_at": null,
    "created_at": "2026-04-13T10:00:00Z"
  },
  {
    "id": "c4ad96g7-5678-5673-c4gd-3d074g77bg22",
    "property": {
      "id": "4gb96g75-6828-5673-c4gd-3d074g77bg33",
      "title": "Casa 4 quartos Alphaville",
      "slug": "casa-4-quartos-alphaville"
    },
    "message": "Tenho interesse em visitar esta semana.",
    "status": "confirmed",
    "scheduled_at": "2026-05-01T10:00:00Z",
    "created_at": "2026-04-10T08:30:00Z"
  }
]

Ordenado por created_at DESC. Lista vazia [] quando sem visitas.

property pode ser null se o imóvel foi removido do banco. scheduled_at é null enquanto status for pending.


Response 401 Unauthorized

{ "error": "Token inválido ou ausente" }