← API REST v1 SECCIÓN DEL MANUAL

9. OLT (aprovisionamiento)

Instrucciones, comprobaciones y pasos de esta sección del manual.

Prueba esta ruta en el laboratorio

Abre el laboratorio estilo Postman, indica la URL de tu panel y envía la petición. Recuerda activar la API en Ajustes → Gestión de personal.

Los listados leen el espejo en base de datos (el mismo que el panel). No abren CLI ni SNMP. Las credenciales de la OLT no se exponen.

Permiso de lectura: gestion_red.olt.menu. Alta de ONU: gestion_red.olt.editar.

Flujo típico: GET /oltsGET /olts/{id}/catalogPOST /olts/{id}/provisionGET /olts/{id}/jobs/{job_id}.

GET /olts

Filtros: q, manufacturer.

GET /olts/{id}

GET /olts/{id}/catalog

Paquete para aprovisionar: OLT, VLANs, perfiles (dba, line, srv, traffic, onu, tr069), tipos ONU, puertos PON y required_fields según fabricante.

GET /olts/{id}/vlans

GET /olts/{id}/profiles

Sin type devuelve todos los tipos. Filtro: type=dba|line|srv|traffic|onu|tr069.

GET /olts/{id}/onu-types

GET /olts/{id}/ports

GET /olts/{id}/onus

Filtro: status=Online.

POST /olts/{id}/provision

Encola el mismo job onu_register que el panel. Permiso: gestion_red.olt.editar.

{
  "service_id": 8,
  "sn": "ZTEGA4C02EB8",
  "vlan_id": 100,
  "board": 0,
  "port": 1,
  "onu_type": "ZTE-F660V5.2",
  "lineprofile_id": 2,
  "srvprofile_id": 1,
  "dba_profile_id": 2
}

Respuesta 201: job.id, job.status, sn, vlan_id.

Huawei exige lineprofile_id y srvprofile_id presentes en el catálogo. VSOL exige vlan_id; onu_type es el nombre de profile ONU.

GET /olts/{id}/jobs/{job_id}

Estado del job de aprovisionamiento (queued, running, completed, failed).