AutoSinSorpresas API (Proyecto Educativo)

API REST educativa en PHP + SQLite para consultar información de vehículos y multas por patente.

Objetivo

Este proyecto fue creado para practicar diseño de endpoints, consumo de parámetros, manejo de respuestas JSON y conexión a base de datos.

Stack

• PHP (sin framework)
• SQLite (PDO)
• JSON API

Estructura

• informe.php: endpoint principal de consulta por patente.
• estado/index.php: endpoint protegido para listar estados.
• estado/modelo multas/vehiculo.php: acceso a datos de vehículos.
• estado/modelo multas/multa.php: acceso a datos de multas.
• conexion.php: clase de conexión SQLite con PDO.
• apiV1.php: utilidades base para headers, auth y parsing.
• db/schema.sql: esquema de base de datos.
• db/seed.sql: datos de ejemplo.
• init_db.php: inicializador de base con PHP.

Configuración local rápida (2 minutos)

1. Define la ruta de la base:

• DB_PATH=./db/autosinsorpresas.sqlite

2. Crea la base y carga datos de ejemplo (sin dependencias extra):

php init_db.php

Opcional si tienes sqlite3 instalado:

sqlite3 db/autosinsorpresas.sqlite < db/schema.sql
sqlite3 db/autosinsorpresas.sqlite < db/seed.sql

3. Levanta el servidor PHP:

php -S localhost:8000

Endpoints

1) Obtener informe por patente

• GET /informe.php?patente=ABC123

2) Listar estados (protegido)

• GET /estado/index.php
• Header requerido: Authorization: Bearer portfolio-demo-token

Ejemplo curl:

curl -H "Authorization: Bearer portfolio-demo-token" http://localhost:8000/estado/index.php

Nota de seguridad

Este repositorio está orientado a aprendizaje. Para uso productivo se recomienda:

• token por entorno y rotación
• validación estricta de inputs
• logging estructurado y monitoreo
• pruebas automatizadas