Convenciones de API

Contenido de ejemplo — documentación real pendiente de completar por el equipo.

Rutas

GET    /api/v1/propiedades
POST   /api/v1/propiedades
GET    /api/v1/propiedades/{id}
PUT    /api/v1/propiedades/{id}
DELETE /api/v1/propiedades/{id}

Siempre en kebab-case, siempre versionadas (v1).

Headers de respuesta

Toda respuesta — éxito o error — incluye:

X-App-Code: portal-arriendo-api

Formato de error

{
  "error": {
    "code": "PROPERTY_NOT_FOUND",
    "message": "La propiedad solicitada no existe o no tienes acceso a ella."
  }
}

Autenticación

Todo endpoint espera un Bearer token emitido por Auth, salvo los explícitamente públicos (ej. búsqueda pública de propiedades).

Authorization: Bearer eyJhbGciOiJSUzI1NiIs...