Documentación · API de renderizado

Envía una especificación y descarga un gráfico

Para procesos, informes y aplicaciones que necesitan una imagen en lugar de una inserción: un pequeño servicio HTTP que convierte la misma especificación JSON en PNG o SVG.

Imágenes de Treemap

Treemap admite PNG y SVG. Envía type: "treemap" con el formato nodes: hasta 6 grupos y 36 elementos con valores positivos o ausentes. El motor carga el módulo antes de validar. Las imágenes muestran toda la jerarquía; abrir un grupo es una acción interactiva del lector. Las peticiones repetidas con la misma especificación y tamaño producen bytes idénticos.

Instalación con licencia

Contacta con soporte sobre la instalación y configuración. El servicio mantiene Chromium sin interfaz preparado, procesa las peticiones en una cola e incluye las fuentes en la imagen de instalación. El contrato de la API se aplica cuando tu servicio con licencia está en marcha.

GET /healthz responde {"ok": true} cuando el servicio está en marcha.

Imágenes de Ridgeline, caja y dispersión X-Y

Ridgeline admite PNG y SVG con el formato groups. Envía observaciones sin agrupar de hasta 12 grupos y 2000 mediciones, incluidos valores null. El motor carga el módulo antes de validar. El ancho de banda, la escala de altura y la ordenación por mediana coinciden con el gráfico en vivo; las mismas entradas producen bytes de imagen idénticos.

El diagrama de caja admite PNG y SVG con el mismo formato groups.

La dispersión X-Y admite PNG y SVG con el formato points: hasta 2000 puntos y 12 grupos, con la recta de regresión, su ecuación y r dibujados como en el gráfico en vivo.

PNG

curl -X POST http://localhost:8787/render \
  -H "Content-Type: application/json" \
  -d '{
    "spec": {
      "type": "column",
      "theme": "editorial",
      "title": "Weekly signups",
      "data": {
        "labels": ["Mon", "Tue", "Wed", "Thu", "Fri"],
        "series": [{ "name": "Signups", "values": [12, 19, 14, 27, 22] }]
      }
    }
  }' \
  --output chart.png
# -> a 1920x1080 PNG (960x540 at 2x, the defaults)

SVG

Añade "format": "svg" y no se usa el navegador: análisis, construcción de escena y serialización son cálculos puros, por lo que generar SVG es ligero y exacto. scale se ignora porque los vectores no tienen píxeles. Las familias tipográficas se referencian por nombre; no se incrustan.

curl -X POST http://localhost:8787/render \
  -H "Content-Type: application/json" \
  -d '{ "format": "svg", "spec": { ...same spec... } }'
# -> a standalone <svg>, no browser involved

Todos los límites

El servicio trata cada petición como no fiable y rechaza las tareas excesivas antes de ejecutar las operaciones costosas:

Errores

Las entradas no válidas devuelven 400 con la misma lista {path, message, hint} que el resto del proyecto; las rutas desconocidas, 404; los fallos inesperados, 500. Una especificación incorrecta no provoca una caída del servicio:

{
  "errors": [{
    "path": "type",
    "message": "Unknown chart type \"pei\"",
    "hint": "Use one of: line, area, bar, column, stacked, donut, scatter, number, dotplot, lollipop, dumbbell, range, waterfall, bullet, slope, heatmap, waffle, matrix, table, treemap, sunburst, bump, streamgraph, ridgeline, boxplot, xy, sankey"
  }]
}

El renderizado en tu servidor requiere Team o una licencia OEM. Consulta la licencia de Meiku Charts.