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.
Metodo: POST
Tipo di contenuto: application/json
Header: X-Api-Key: <la tua chiave>
Endpoint
https://nanomid.com/api/Partner/PlayList{
"licence": "CODICE_LICENZA",
"title": "Sample List",
"url": "https://example.com/list.m3u"
}| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| licence | String | Sì | Il codice della licenza, come appare nella dashboard. Deve essere una delle tue licenze. |
| title | String | Sì | Nome della playlist, da 3 a 25 caratteri. |
| url | String | Sì | 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.
| Codice | Descrizione |
|---|---|
| 200 | Playlist aggiunta: la risposta contiene title, key (identifica la playlist), source, createdAt e hiddenInfo |
| 400 | licence mancante, oppure title o url non validi |
| 401 | X-Api-Key mancante, sbagliata, rigenerata o eliminata |
| 404 | Nessuna licenza con quel codice tra le tue |
| 410 | Licenza scaduta |
| 429 | Troppe richieste: riprova dopo i secondi indicati in Retry-After |
| 500 | Errore del server (molto raro) |
Con troppe richieste la risposta è 429: riprova dopo i secondi indicati in Retry-After.
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.