API · GuidaTV.uno

API REST per sviluppatori e partner editoriali

GuidaTV.uno estende il proprio servizio di palinsesto con un’API REST dedicata agli sviluppatori e ai partner editoriali. L’obiettivo è chiaro: rendere disponibili, in modo controllato, i dati di programmazione già usati dal sito — canali free, pay e FAST come Pluto TV.

GuidaTV.uno punta su questo spazio: non solo consultazione umana, ma accesso strutturato alla stessa fonte usata dalla nuova interfaccia del sito.

Come funziona l’accesso

L’API non è aperta in modo anonimo. Ogni chiamata richiede un’API key generata:

  • nell’header X-XMLTV-Key, oppure
  • come parametro api_key nella query string.

Documentazione tecnica completa e esempi di chiamata

Vedi documentazione API

Documentazione interattiva

API Guida TV

API disattivata. Attivala in Impostazioni → API.

Base URL: https://www.guidatv.uno/wp-json/xmltv/v1

Autenticazione: header X-XMLTV-Key: TUA_API_KEY oppure query ?api_key=TUA_API_KEY

Key configurata (mascherata): (non configurata)

Endpoint

Metodo Path Parametri Descrizione
GET /status — Stato plugin, sorgenti, conteggio canali
GET /sources — Elenco sorgenti (free, pay, pluto…)
GET /channels source, category, search, limit Lista canali
GET /channel/{source}/{id} path Dettaglio canale + ora / a seguire
GET /now source*, id*, next Programma in onda e successivi
GET /schedule source*, id*, days (1–7) Palinsesto multi-giorno
GET /search q*, source, limit Cerca titolo nei programmi in onda / a seguire

Esempi

# Status
curl -H "X-XMLTV-Key: TUA_KEY" https://www.guidatv.uno/wp-json/xmltv/v1/status

# Canali free
curl -H "X-XMLTV-Key: TUA_KEY" "https://www.guidatv.uno/wp-json/xmltv/v1/channels?source=free&limit=20"

# Ora in onda
curl -H "X-XMLTV-Key: TUA_KEY" "https://www.guidatv.uno/wp-json/xmltv/v1/now?source=free&id=Rai1.it&next=3"

# Oppure con query key
curl "https://www.guidatv.uno/wp-json/xmltv/v1/status?api_key=TUA_KEY"

Shortcode documentazione:

API Guida TV

API disattivata. Attivala in Impostazioni → API.

Base URL: https://www.guidatv.uno/wp-json/xmltv/v1

Autenticazione: header X-XMLTV-Key: TUA_API_KEY oppure query ?api_key=TUA_API_KEY

Key configurata (mascherata): (non configurata)

Endpoint

Metodo Path Parametri Descrizione
GET /status — Stato plugin, sorgenti, conteggio canali
GET /sources — Elenco sorgenti (free, pay, pluto…)
GET /channels source, category, search, limit Lista canali
GET /channel/{source}/{id} path Dettaglio canale + ora / a seguire
GET /now source*, id*, next Programma in onda e successivi
GET /schedule source*, id*, days (1–7) Palinsesto multi-giorno
GET /search q*, source, limit Cerca titolo nei programmi in onda / a seguire

Esempi

# Status
curl -H "X-XMLTV-Key: TUA_KEY" https://www.guidatv.uno/wp-json/xmltv/v1/status

# Canali free
curl -H "X-XMLTV-Key: TUA_KEY" "https://www.guidatv.uno/wp-json/xmltv/v1/channels?source=free&limit=20"

# Ora in onda
curl -H "X-XMLTV-Key: TUA_KEY" "https://www.guidatv.uno/wp-json/xmltv/v1/now?source=free&id=Rai1.it&next=3"

# Oppure con query key
curl "https://www.guidatv.uno/wp-json/xmltv/v1/status?api_key=TUA_KEY"

Shortcode documentazione: [xmltv_api_docs]