Guía de Integración de API de IPTV y Xtream Codes para Propietarios de Paneles

Para desarrolladores, propietarios de marcas blancas y revendedores avanzados, la integración directa con la API de Xtream Codes permite crear herramientas personalizadas de alto valor, como reproductores web, formularios automatizados de registro de pruebas y paneles de administración de facturas alternativos.

⚙️ Arquitectura y Endpoints de la API

La API de Xtream Codes opera mediante peticiones HTTP GET y POST estándar que devuelven estructuras en formato JSON. A continuación, se detallan las llamadas fundamentales para su integración de software:

1. Autenticación Básica e Información de Suscripción:

GET http://portal.sumarca.com:8080/player_api.php?username=CLIENTE_USER&password=CLIENTE_PASS

Respuesta JSON Clave:

{
  "user_info": {
    "username": "cliente_user",
    "status": "Active",
    "exp_date": "1780158414",
    "max_connections": 1,
    "active_cons": 0
  },
  "server_info": {
    "url": "portal.sumarca.com",
    "port": "8080"
  }
}

2. Consulta de Canales en Vivo por Categoría:

GET http://portal.sumarca.com:8080/player_api.php?username=CLIENTE_USER&password=CLIENTE_PASS&action=get_live_streams

3. Obtención de URL M3U de Descarga Directa:

GET http://portal.sumarca.com:8080/get.php?auth=CLIENTE_USER&auth_password=CLIENTE_PASS&output=ts

⚡ Prácticas Heurísticas de Alto Rendimiento para Desarrolladores

• Implementación de Redis Caching: Nunca realice llamadas a la API de Xtream Codes en tiempo real para cada visita a su sitio web o aplicación móvil. Guarde la lista de categorías y canales en una base de datos en caché local (ej. Redis) con una duración de 6 a 12 horas. De lo contrario, un pico de tráfico saturará la base de datos de su panel de IPTV, causando una denegación de servicio (DDoS autoinducido).
• Tratamiento de Tiempos Epoch: La API devuelve las fechas de vencimiento de suscripción en formato de marca de tiempo Unix (Epoch). Asegúrese de convertirlos mediante Javascript utilizando new Date(exp_date * 1000) para mostrarlos en formatos comprensibles para el usuario final.