Zum Inhalt springen

Ein Link ist ein Bild. Oder ein Video.

Für personalisierte Bilder in Newslettern, Open-Graph-Bilder für jede Seite oder Zertifikate auf Abruf: Die Adresse enthält Vorlage und Daten, die Antwort ist die fertige Datei.

Render per URL

Was dazugehört

Daten als Parameter

template_id, output_format und jedes Feld der Vorlage als Query-Parameter. Optional frame_rate, render_scale, max_width und max_height.

Signiert mit Ihrem Schlüssel

Die Signatur ist HMAC-SHA256 über die vollständige URL mit Ihrem API-Schlüssel. Sie bestimmen je Arbeitsbereich, ob unsignierte Aufrufe Ihrer Vorlagen erlaubt sind.

Zwischenspeicher

Dieselbe Adresse liefert dieselbe Datei, solange sie aufbewahrt wird, ohne neue Credits. Mit cache=no wird neu gerendert.

Überall, wo eine Bild-URL passt

E-Mail-Programme, Webseiten, Social-Media-Vorschauen, No-Code-Tools. Die Antwort wartet, bis die Datei fertig ist.

Beispiel

So sieht das im Code aus

// Render per URL: Signatur = HMAC-SHA256(API-Schlüssel, URL ohne &signature), als letzter Parameter
import crypto from 'node:crypto';

const url = 'https://render.agiledeveloper.de/v1/direct?template_id=c2d6b7e4-…'
  + '&output_format=jpg&Titel=' + encodeURIComponent('Willkommen, Jana');
const signature = crypto.createHmac('sha256', process.env.AGILE_RENDER_KEY).update(url).digest('hex');
const bild = url + '&signature=' + signature;
// <img src={bild}> liefert das fertige Bild, gleiche URL = gleiche Datei (Cache)

Fragen

Fragen zu Render per URL

Noch etwas offen? info@agiledeveloper.de

Kann jeder meine Links aufrufen?

Wer einen signierten Link hat, kann ihn aufrufen, so funktionieren Bilder in E-Mails. Ändert jemand einen Parameter, passt die Signatur nicht mehr. Im strengsten Modus rendern nur signierte Adressen; jeder neue Render verbraucht Credits Ihres Kontos.

Wie lange dauert die Antwort?

Bilder sind meist nach wenigen Sekunden da. Die Antwort wartet bis zu 100 Sekunden auf die fertige Datei; für lange Videos ist die API mit Webhook der bessere Weg.

Probieren Sie es mit Ihren eigenen Daten.

Kostenlos registrieren, Startvorlage wählen oder importieren, rendern.

50 Credits im Monat gratis · Keine Kreditkarte · Jederzeit kündbar

Render per URL: Bilder und Videos über einen Link erzeugen · Agile Render