# Radio Spot – Playout API v1

Svi zahtjevi koriste zaglavlje `Authorization: Bearer API_KLJUC`. Ključ se generira u **Postavke → Windows instalacije**.

## Manifest i konfiguracija

`GET /api/v1/playout/manifest`

Vraća verziju API-ja, interval provjere, vremensku zonu, identitet instalacije te početni i završni jingle. Windows aplikacija ovaj endpoint poziva pri pokretanju.

## Heartbeat

`POST /api/v1/playout/heartbeat`

JSON: `{ "app_version": "1.0.0" }`

## Dnevni plan

`GET /api/v1/playout/day?date=2026-08-24`

Vraća blokove, redoslijed spotova, lokalne playout putanje, stabilni `revision` hash i odbijene stavke. Blank spotovi i spotovi bez playout putanje nikad se ne vraćaju u `blocks`. Windows aplikacija provjerava plan svakih 10 sekundi i ponovno generira FPS samo kada se `revision` promijeni.

## Evidencija FPS izvoza

`POST /api/v1/playout/exports`

Primjer JSON-a:

```json
{
  "date": "2026-08-24",
  "block_id": 12,
  "status": "downloaded",
  "file_name": "12-13-Blok1-ponedjeljak.fps",
  "content_hash": "SHA256_HASH_DATOTEKE"
}
```

Status može biti `generated`, `downloaded` ili `error`. Kod greške poslati i `error_message`.