Dokumentation · Render-API

Spezifikation senden, Diagramm herunterladen

Für Pipelines, Berichte und Anwendungen, die ein Bild statt einer Einbettung benötigen: Ein kleiner HTTP-Dienst verwandelt dieselbe JSON-Spezifikation in PNG oder SVG.

Auf deinem Server · Kontaktiere uns

Dein Server, dein Ablauf

Kontaktiere uns für einen lizenzierten Render-Server. Für Rendering innerhalb eines Produkts für deine Kunden ist eine OEM-Lizenz erforderlich. Die Beispiele unten verwenden localhost:8787 auf einer lizenzierten Installation. Vergleiche die Tarife oder kontaktiere uns zur Einrichtung.

Gehostetes Diagramm-Rendering

Über deinen KI-Assistenten

Nutze den KI-Connector, um SVG-Diagramme innerhalb der Fair-Use-Limits zu rendern. Der hier dokumentierte eigenständige HTTP-Endpunkt gehört zu lizenzierten Installationen auf eigenen Servern. Es gibt keinen öffentlichen gehosteten HTTP-Endpunkt.

Treemap-Bilder

Treemap unterstützt PNG und SVG. Sende type: "treemap" im nodes-Format: höchstens 6 Gruppen und 36 Elemente mit positiven oder fehlenden Werten. Der Renderer lädt das Diagrammmodul vor der Validierung. Bilder zeigen die ganze Hierarchie; das Öffnen einer Gruppe ist eine interaktive Funktion für Betrachter. Gleiche Spezifikation und Abmessungen ergeben bei wiederholten Anfragen identische Bytes.

Lizenzierte Installation

Kontaktiere den Support für Installation und Einrichtung. Im Render-Dienst bleibt Headless Chromium bereit, Anfragen werden als Warteschlange verarbeitet und Schriftarten mit dem Image geliefert. Der folgende API-Vertrag gilt, sobald dein lizenzierter Dienst läuft.

GET /healthz antwortet mit {"ok": true}, sobald der Dienst läuft.

Bilder von Ridgeline, Boxplot und X-Y-Streudiagrammen

Ridgeline unterstützt PNG und SVG im groups-Format. Sende Rohmessungen für bis zu 12 Gruppen und 2.000 Messwerte einschließlich null-Einträgen. Der Renderer lädt das Modul vor der Validierung. Bandbreite, Höhenskala und Mediansortierung entsprechen dem Live-Diagramm. Wiederholte Anfragen mit denselben Eingaben ergeben identische Bildbytes.

Boxplot unterstützt PNG und SVG mit demselben groups-Format.

X-Y-Streudiagramme unterstützen PNG und SVG im points-Format: bis zu 2.000 Punkte und 12 Gruppen, mit Trendlinie, Gleichung und r wie im Live-Diagramm.

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)

Parameter	Standardwert	Grenzen
`spec`	erforderlich	Dieselbe Spezifikation wie in der Spezifikationsreferenz.
`width`	960	64–4096
`height`	540	64–4096
`scale`	2	1–4 (Gerätepixel-Multiplikator; das fertige PNG hat width×scale mal height×scale Pixel)

SVG

Ergänze "format": "svg", dann wird kein Browser benötigt. Parsing, Szenenaufbau und Serialisierung sind reine Berechnungen; SVG-Rendering ist dadurch ressourcenschonend und exakt. scale wird ignoriert, denn Vektoren haben keine Pixel. Schriftfamilien werden namentlich referenziert und nicht eingebettet.

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

Alle Limits

Der Dienst behandelt jede Anfrage als nicht vertrauenswürdig und lehnt zu große Aufgaben vor den aufwendigen Schritten ab:

Limit	Wert	Bei Überschreitung
Anfrageinhalt	1 MiB	413
Werte aller Datenreihen zusammen	10.000	400, strukturierter Fehler
Gezeichnete Punkte (dotplot)	10.000	400, strukturierter Fehler
Endgültige PNG-Fläche (width×scale × height×scale)	16.777.216 px	400, strukturierter Fehler

Fehler

Ungültige Eingaben liefern 400 mit derselben Liste aus {path, message, hint} wie überall im Projekt. Unbekannte Routen liefern 404, unerwartete Fehler 500. Eine fehlerhafte Spezifikation führt niemals zu einem Absturz:

{
  "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"
  }]
}

Rendering auf deinem Server erfordert Team oder eine OEM-Lizenz. Siehe Meiku-Charts-Lizenz.