API Developer

API REST Nanomid Player

Utilizzo delle API

L'API è riservata ai rivenditori: il tuo gestionale può aggiungere una playlist a una delle tue licenze. Serve una chiave API, che crei in Impostazioni → Chiave API, e vale solo per le licenze del tuo account.

HTTPS è obbligatorio. Nanomid risponde solo al traffico crittografato in modo che i tuoi dati rimangano al sicuro.

Tieni la chiave sul tuo server, mai in un'app o in una pagina web. Se pensi che qualcuno la conosca, rigenerala da Impostazioni → Chiave API: la vecchia smette subito di funzionare.

Invia una playlist

Metodo: POST
Tipo di contenuto: application/json
Header: X-Api-Key: <la tua chiave>

Endpoint

https://nanomid.com/api/Partner/PlayList

Esempio di payload

{ "licence": "CODICE_LICENZA", "title": "Sample List", "url": "https://example.com/list.m3u" }

POST /api/Partner/PlayList

CampoTipoObbligatorioDescrizione
licenceStringSìIl codice della licenza, come appare nella dashboard. Deve essere una delle tue licenze.
titleStringSìNome della playlist, da 3 a 25 caratteri.
urlStringSìIndirizzo della playlist, http o https.

Le informazioni della playlist sono sempre nascoste ai clienti. Se un dispositivo usa già la licenza, riceve la playlist subito o al controllo successivo; altrimenti la riceve quando si inserisce il codice.

Codici di risposta

CodiceDescrizione
200Playlist aggiunta: la risposta contiene title, key (identifica la playlist), source, createdAt e hiddenInfo
400licence mancante, oppure title o url non validi
401X-Api-Key mancante, sbagliata, rigenerata o eliminata
404Nessuna licenza con quel codice tra le tue
410Licenza scaduta
429Troppe richieste: riprova dopo i secondi indicati in Retry-After
500Errore del server (molto raro)

Con troppe richieste la risposta è 429: riprova dopo i secondi indicati in Retry-After.

Esempio di richiesta

curl -X POST "https://nanomid.com/api/Partner/PlayList" \ -H "X-Api-Key: nmk_..." \ -H "Content-Type: application/json" \ -d '{"licence":"CODICE_LICENZA","title":"Sample List","url":"https://example.com/list.m3u"}'

Nanomid Privacy Pass agisce come un reverse proxy verso il server del fornitore dei servizi. Quest'ultimo dovrà settare il proprio webserver in modo da ottenere l'ip reale del cliente e non quello dei nostri proxy.

Segue un esempio per il webserver nginx.

Nginx

Inserire le direttive seguenti nel file nginx.conf


http {
real_ip_header X-Forwarded-For;
set_real_ip_from 0.0.0.0/0;
real_ip_recursive on;
}

In questo modo il vostro webserver o proxy riceveranno l'ip reale del cliente e non dei nostri server.

Se hai un firewall e ti serve l'elenco degli IP dei nostri server, contatta l'assistenza.