Documentación API

Integra tu infraestructura y automatiza flujos externos. Resumen técnico y endpoints disponibles (V1).

Diccionario de Datos

Clientes & Planes

Entidad principal. Un cliente puede estar activo, suspendido o en mora, y siempre tiene asignado un plan de ancho de banda.

Topología (Nodos/Routers)

El hardware físico. Cada router MikroTik se registra con su IP/VPN para que la API envíe comandos remotamente.

Eventos (Triggers)

Acciones del sistema. Un "Pago Recibido" dispara el evento "Reconexión", que a su vez llama a la API de MikroTik.

REST API (Endpoints Core)

Autenticación requerida vía Bearer Token en los headers de la petición.

bash - api/v1

GET  /api/v1/clientes                  # Lista todos los clientes y su estado
POST /api/v1/clientes                  # Crea un nuevo cliente (PPPoE/Hotspot)
POST /api/v1/clientes/{id}/suspender    # Corta el servicio en el MikroTik
POST /api/v1/clientes/{id}/activar      # Reconecta el servicio al registrar pago

Webhooks (Suscripción a Eventos)

Configura una URL en tu panel para que OneWISP te envíe un JSON (POST) cada vez que ocurra algo en tu red. Ideal para conectar con bots de WhatsApp.

pago_confirmado

cliente_suspendido

cliente_activado

ticket_creado

alerta_nodo_caido

¿Quieres acceder a la API real?

Solicitar Demo Técnica

Validaremos la arquitectura técnica de tu red en una reunión.