Autenticación — API Predial

Autentica al usuario y devuelve un token JWT que debe utilizarse en todas las demás peticiones.

POST /api/predial/login

Encabezados

Encabezado	Requerido	Descripción
`Ambiente`	requerido	`0` = pruebas, `1` = producción
`Content-Type`	requerido	`application/json`

Cuerpo de la petición

{
  "ctrl_persona": "1234567",
  "password": "contraseña"
}

Campo	Tipo	Descripción
`ctrl_persona`	string	Alias o número de control del usuario
`password`	string	Contraseña del usuario

Respuesta exitosa

{
  "estatus_ejecucion": 1,
  "mensaje_ciudadano": "",
  "mensaje_tecnico": "",
  "Token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "nombre_sistema": "AJALPANPRED",
  "control_persona": 42,
  "nombre": "Juan Pérez López"
}

Campo	Tipo	Descripción
`Token`	string	JWT Bearer — incluirlo en `Authorization: Bearer <Token>`
`nombre_sistema`	string	Identificador del sistema municipal
`control_persona`	int	ID interno del usuario autenticado
`nombre`	string	Nombre completo del usuario

Uso del token

Incluye el token en el encabezado Authorization de todas las peticiones posteriores:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

El token tiene una vigencia configurada en el servidor (por defecto 8 horas). Cuando expire, repite el proceso de Login para obtener uno nuevo.

Respuesta de error

{
  "estatus_ejecucion": 0,
  "mensaje_ciudadano": "Credenciales incorrectas",
  "mensaje_tecnico": ""
}

Ambiente inválido Si se envía un valor de Ambiente distinto de 0 o 1, se devuelve estatus_ejecucion: 0.