API personalizada
Mostrar en un widget los valores de cualquier API JSON, leída por el servidor NasDash.
El widget API personalizada muestra los valores de cualquier servicio que responda en JSON por HTTP(S): una prueba de velocidad, la salud de los discos, un SAI, un sensor, una página de estado… todo lo que no tiene su propio widget.
Añadir una API
-
Abra Ajustes → Integraciones → API personalizadas y elija API personalizada.
-
Póngale un nombre e introduzca la dirección que responde en JSON (por ejemplo
https://service.example.com/api/status). -
Elija la Autenticación que espera el servicio:
Opción Enviado por el servidor Ninguna Nada Token (Bearer) Authorization: Bearer <key>Cabecera <name>: <key>(por ejemploX-Api-Key)Usuario y contraseña Autenticación HTTP Basic Parámetro de URL ?<name>=<key>añadido a la dirección -
Active Aceptar un certificado autofirmado solo para un servidor suyo que lo use, guarde y pruebe la conexión.
La clave se guarda con los demás secretos de conexión. El servidor lee la API (sin redirecciones, 1 MiB y 6 segundos como máximo); el navegador nunca recibe la dirección, la clave ni la respuesta completa.
Elegir los valores
Añada el widget y abra sus ajustes (✎). La respuesta de la API aparece a la derecha como un árbol. Haga clic en + junto a un valor para añadirlo (12 como máximo); el + de una lista añade su número de elementos. Para cada valor, ajuste su etiqueta, su formato (número, porcentaje, tamaño, velocidad, duración, fecha, hace…, texto, sí/no) y su unidad; el botón de controles ajusta los decimales, la escala de los indicadores y los umbrales de aviso y crítico (con Más bajo es peor para una batería o un espacio libre).
| Visualización | Muestra |
|---|---|
| Cifras | Cada valor en grande, con su etiqueta |
| Indicadores | Anillos en la escala de cada valor (0–100 por defecto) |
| Lista | Etiquetas y valores, uno por línea |
| Tabla | Una fila por elemento de una lista: elija Usar como tabla en una lista y luego las columnas en su primer elemento (hasta 50 filas) |
| Estado | En servicio o Problema según un valor; opcionalmente el valor que significa que todo va bien y una leyenda |
El widget se actualiza cada 15 s a 15 min. Varios widgets que leen la misma API comparten una sola petición.
Acceso
Los visitantes solo ven el widget con el permiso API personalizada (Ajustes → Usuarios y acceso). Solo los valores elegidos en un widget salen del servidor. La demo pública lee una API ficticia.