# Hotspot API

Backend FastAPI per riconoscimento e matching hotspot europei.

## Endpoints

| Metodo | Endpoint | Descrizione |
|--------|----------|-------------|
| GET | `/` | Info servizio |
| GET | `/health` | Health check |
| GET | `/hotspots` | Lista tutti gli hotspot |
| GET | `/hotspots/{id}` | Singolo hotspot |
| POST | `/match` | Cerca corrispondenza per testo |
| POST | `/reload` | Ricarica database JSON |

## Esempio chiamata /match

```bash
curl -X POST "https://api.tuodominio.com/match" \
  -H "Content-Type: application/json" \
  -d '{"text": "Brussels", "language": "en"}'
```

Risposta:
```json
{
  "found": true,
  "hotspot_id": "1",
  "name": "Brussels",
  "confidence": 1.0,
  "video_ids": [133]
}
```

## Deploy su Coolify

1. Crea un nuovo progetto
2. Add Resource → Docker Image o Git repository
3. Se usi Git, punta al repo con questo codice
4. Configura il volume: `/data` → persistent storage
5. Carica `hotspots.json` in `/data/`
6. Deploy!

## Aggiornare il database

1. Carica il nuovo `hotspots.json` via SFTP in `/data/`
2. Chiama `POST /reload` oppure fai redeploy

## Documentazione API

Dopo il deploy, visita `/docs` per la documentazione Swagger interattiva.