Zum Inhalt springen
Ironfang
de

Sprache

EnglishDeutschFrançais

Signierte Render-URLs

Stecken Sie das Rendering in die URL

Erzeugen Sie eine signierte URL von Ironfang Render und verwenden Sie sie direkt in einer Seite, einem og:image-Tag oder einer E-Mail. Sie rendert bei der ersten Anfrage und kommt danach aus dem Cache, sodass Ihre Anwendung die Datei nie selbst erzeugen, speichern oder ausliefern muss.

Kostenloses Konto erstellenAPI-Dokumentation lesen

  • Kein Schlüssel im Markup
  • Kein temporärer Bucket
  • Wiederholungen aus dem Cache kostenlos
  • Läuft nie ab, wenn Sie wollen
POST /render/v1/sign
Authorization: Bearer if_live_...

{
  "kind": "image",
  "template": "og-card",
  "vars": { "title": "Why we own our hardware" },
  "width": 1200,
  "height": 630,
  "ttl_hours": 0
}

<meta property="og:image"
      content="https://api.ironfang.uk/render/v1/
               results/0/8a13c09e4f22..." >

Was sie ersetzt

Die Rendering-Infrastruktur, die Sie nicht mehr schreiben

Für jede Seite ein Bild zu erzeugen ist vor allem Infrastruktur. Eine signierte URL entfernt die Infrastruktur und behält das Bild.

Ohne sie

  • Einen Rendering-Worker betreiben oder einen Job einreihen und abfragen
  • Das Ergebnis irgendwo öffentlich ablegen und den Bucket am Leben halten
  • Invalidieren und neu erzeugen, wenn sich der zugrunde liegende Inhalt ändert
  • Ein API-Geheimnis in dem halten, was das Markup erzeugt

Mit einer signierten URL

  • Eine signierte URL einmal auf Ihrem Server erzeugen
  • Sie ins Markup, ins Tag oder in die E-Mail setzen
  • Ironfang Render rendert beim ersten GET und liefert den Rest aus dem Cache
  • Kein Schlüssel in der Seite, kein Bucket, kein Worker

So funktioniert es

Einmal signiert, bei Bedarf gerendert

Ihr Server hält den Schlüssel. Die Seite hält eine URL, die sich nicht manipulieren lässt.

Ihr Server erzeugt eine URL
Die URL kommt ins Markup
Ironfang Render rendert beim GET
  • Die Signatur deckt die Parameter ab, sodass Ziel, Größe und Vorlage von niemandem geändert werden können, der den Link hat.
  • Das erste GET rendert. Jedes identische GET danach ist ein Cache-Treffer und kostet nichts.
  • Renderings werden dem Konto angerechnet, das die URL erzeugt hat, unter denselben festen Obergrenzen wie der Rest Ihrer Nutzung.

Wo es passt

Zwei Arten und die Orte, an die sie gehören

Eine signierte URL rendert eine Seitenaufnahme oder eine gespeicherte Vorlage. Das sind die beiden Dateien, die meist unter einer URL existieren müssen.

Open Graph und Social Cards

Gestalten Sie eine Vorlage, erzeugen Sie pro Seite eine URL mit Titel, Autor oder Preis als Variablen und setzen Sie sie direkt ins og:image-Tag. Ändern Sie die Vorlage, und jede Karte folgt, ohne Rebuild und ohne etwas zu leeren.

Vorlagen-Rendering in der Dokumentation

Seitenaufnahmen an Ort und Stelle

Betten Sie eine Live-Aufnahme einer Seite in ein Dashboard, eine Statustafel, eine Übersichts-E-Mail oder einen Verzeichniseintrag ein. Das Bild ist aktuell, wenn es abgerufen wird, statt nur so frisch wie Ihr letzter Cron-Lauf.

Siehe auch die QR-Code-API

Fragen

Bevor Sie integrieren

Die Details, die entscheiden, ob es passt, ohne vorher die ganze Referenz zu lesen.

Legt die URL meinen API-Schlüssel offen?
Nein. Der Schlüssel erzeugt die URL und steht nie in ihr. Die URL trägt die Anfrageparameter und eine Signatur darüber, sodass ein Besucher Ziel, Größe oder Vorlage nicht ändern kann, ohne dass das Rendering verweigert wird.
Wer bezahlt Renderings über eine signierte URL?
Das Konto, das sie erzeugt hat. Renderings werden Ihrem Kontingent genau wie ein direkter API-Aufruf angerechnet, und Wiederholungen derselben URL kommen kostenlos aus dem Cache.
Kann die URL ablaufen?
Das entscheiden Sie. Legen Sie beim Erzeugen eine Lebensdauer in Stunden fest, oder lassen Sie sie auf null für eine URL, die nicht abläuft; das brauchen Sie für ein og:image, das dauerhaft funktionieren muss.
Was kann eine signierte URL rendern?
Einen Screenshot einer URL oder eine gespeicherte Vorlage mit den Variablen, die Sie übergeben. Das deckt die beiden Fälle ab, in denen die Datei unter einer URL existieren muss: Seitenaufnahmen und generierte Bilder.
Kann ich sie in einem og:image-Tag verwenden?
Ja, und genau für diesen Fall gibt es die Funktion. Crawler rufen die URL ab, Ironfang Render rendert sie, und das Bild ist da, ohne dass Ihre Anwendung vorher etwas erzeugt und gespeichert hat.
Kann ich sie in ein img-Tag oder eine E-Mail setzen?
Ja. Es ist ein gewöhnliches HTTPS-GET, das ein Bild zurückgibt, also kann alles, was ein Bild lädt, auch sie laden.

Weniger betreiben. Mehr ausliefern.

Erzeugen Sie Ihre erste signierte URL

Erstellen Sie ein Konto, holen Sie sich einen Schlüssel und signieren Sie eine Anfrage. Das Rendering ist in Ihren kostenlosen Credits enthalten.

Kostenloses Konto erstellenAPI-Referenz lesen

250 kostenlose Credits pro Monat, ohne Kreditkarte, mit festen Nutzungsobergrenzen und kostenlosen Cache-Treffern.