Saltar al contenido
Guía GPON

Cortar y reconectar clientes por API (compatible con SmartOLT)

Cómo corta y reconecta Oltixa una ONU vía su API estilo SmartOLT: endpoints disable/enable, header X-Token y ejemplos curl para integrarlo con tu facturación.

Oltixa expone una API HTTP cuyos paths y autenticación imitan a SmartOLT: si tu sistema de facturación ya habla con SmartOLT, apunta a Oltixa cambiando solo la URL base y el token. El caso más usado es el corte por mora y la reconexión al pagar.

1 · Autenticación

Toda llamada lleva tu token en el header X-Token. Lo generas en tu panel, en Ajustes de API.

X-Token: TU_TOKEN_AQUI

2 · Cortar un cliente (suspender el servicio)

Deshabilita la ONU a nivel administrativo: se corta el internet pero se conserva toda su configuracion (no se borra). El identificador onu_id es el que devuelven los endpoints de listado.

curl -X POST "https://tu-cuenta.oltixa.com/api/onu/disable/12345" \
     -H "X-Token: TU_TOKEN_AQUI"

Respuesta típica:

{ "status": true, "message": "ONU deshabilitada" }

3 · Reconectar al pagar

curl -X POST "https://tu-cuenta.oltixa.com/api/onu/enable/12345" \
     -H "X-Token: TU_TOKEN_AQUI"

4 · Verificar el estado

curl "https://tu-cuenta.oltixa.com/api/onu/get_onu_status/12345" \
     -H "X-Token: TU_TOKEN_AQUI"
Estos tres endpoints (disable, enable, get_onu_status) estan verificados contra OLT ZTE real. Para las marcas aun sin verificar en laboratorio, la orden viaja igual y su respuesta cruda queda en tu registro de comandos, para afinar el driver con el comportamiento real de tu equipo.

5 · Como lo automatiza tu facturacion

Tu WISPA (u otro sistema) le habla a Oltixa por cliente: cuando una factura vence, llama a /api/customer/suspend; cuando el cliente paga, a /api/customer/reactivate (si vienes de SmartOLT, disable/enable por ONU siguen funcionando). Oltixa ejecuta la orden contra el equipo — incluso si la OLT esta detras de NAT sin IP publica, porque Oltixa la alcanza por su Puente (VPN). Ver como se conecta con tu WISPA.

Con Oltixa no necesitas escribir esto a mano: el corte y la reconexion salen de tu panel o de tu facturacion. Prueba Oltixa gratis.

Hazlo con un clic en Oltixa

Tu OLT en un panel: autoriza, cambia planes, corta y mira la señal sin consola. Gratis hasta 1000 ONU.

Crear cuenta gratis