API Developer

API REST Nanomid Player

Uso de la API

La API está reservada a los revendedores: tu sistema de gestión puede añadir una lista a una de tus licencias. Necesitas una clave API, que creas en Ajustes → Clave API, y solo vale para las licencias de tu cuenta.

HTTPS es obligatorio. Nanomid solo responde al tráfico cifrado para que tus datos estén seguros.

Guarda la clave en tu servidor, nunca en una app o en una página web. Si crees que alguien la conoce, regénerala desde Ajustes → Clave API: la antigua deja de funcionar al momento.

Enviar una lista

Método: POST
Tipo de contenido: application/json
Header: X-Api-Key: <tu clave>

Endpoint

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

Ejemplo de payload

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

POST /api/Partner/PlayList

CampoTipoObligatorioDescripción
licenceStringSíEl código de la licencia, tal como aparece en el panel. Debe ser una de tus licencias.
titleStringSíNombre de la lista, de 3 a 25 caracteres.
urlStringSíDirección de la lista, http o https.

La información de la lista siempre está oculta para los clientes. Si un dispositivo ya usa la licencia, recibe la lista enseguida o en la siguiente comprobación; si no, la recibe cuando se introduce el código.

Códigos de respuesta

CódigoDescripción
200Lista añadida: la respuesta contiene title, key (identifica la lista), source, createdAt y hiddenInfo
400falta licence, o title o url no válidos
401X-Api-Key ausente, incorrecta, regenerada o eliminada
404Ninguna licencia con ese código entre las tuyas
410Licencia caducada
429Demasiadas solicitudes: vuelve a intentarlo tras los segundos indicados en Retry-After
500Error del servidor (muy raro)

Con demasiadas solicitudes la respuesta es 429: vuelve a intentarlo tras los segundos indicados en Retry-After.

Ejemplo de solicitud

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 actúa como un proxy inverso hacia el servidor del proveedor de servicios. Este último tendrá que configurar su propio servidor web para poder obtener la ip real del cliente y no la de nuestros proxies.

A continuación se muestra un ejemplo para el servidor web nginx.

Nginx

Coloque las siguientes directivas en el archivo nginx.conf


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

De esta forma su servidor web o proxy recibirá la IP real del cliente y no de nuestros servidores.

Si tienes un firewall y necesitas la lista de IP de nuestros servidores, contacta con el soporte.