← Documentación

Cortar y reconectar clientes por API (compatible con SmartOLT)

OXIOLT Smart · Documentación GPON


OXIOLT Smart expone una API HTTP cuyos paths y autenticación imitan a SmartOLT: si tu sistema de facturación ya habla con SmartOLT, apunta a OXIOLT Smart 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) guarda el match cliente al onu_id. Cuando una factura vence, llama a disable; cuando el cliente paga, llama a enable. OXIOLT Smart solo ejecuta la orden contra el equipo — incluso si la OLT esta detras de NAT sin IP publica, porque OXIOLT Smart la alcanza por su Puente (VPN). Ver como se conecta con tu WISPA.

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

¿Cansado de la consola? Gestiona tu OLT con OXIOLT Smart — gratis 30 días.