Signierte, ablaufende URLs
Jeder Abfrageparameter wird mit Ihrem Schlüssel per HMAC-SHA256 signiert, und jede URL läuft ab. Niemand kann durch das Ändern des Titels Ihre Credits verbrauchen.
Rendra verwandelt eine signierte URL in eine Social Card im Format 1200×630. Wählen Sie eine Vorlage, übergeben Sie Titel und Beschreibung als Abfrageparameter und signieren Sie sie mit Ihrem API-Schlüssel: Crawler erhalten ein PNG, das einen Tag zwischengespeichert und nur einmal berechnet wird. Eine signierte URL wird zu einer Social Card im Format 1200×630. Wählen Sie eine Vorlage, übergeben Sie Titel und Beschreibung und signieren Sie alles mit Ihrem API-Schlüssel. Crawler erhalten ein PNG, das einen Tag zwischengespeichert und nur einmal berechnet wird.
50 Renderings pro Monat kostenlos. Keine Kreditkarte. Anmeldung mit Google oder Magic Link. 50 Renderings pro Monat kostenlos. Keine Kreditkarte.
// the URL in your <meta property="og:image">
https://rendra.alphabros.eu/i/og_standard
?title=Ship+faster
&description=Beautiful+social+cards+from+one+URL
&expires=1788393600
&sig=<key id>.<hmac-sha256 of the sorted query>
// sign it once, server-side (Node)
const digest = createHmac("sha256", RENDRA_API_KEY)
.update(`${path}?${query}`)
.digest("hex");
query.set("sig", `${RENDRA_API_KEY_ID}.${digest}`);
Social Crawler rufen og:image mit einem einfachen GET ab. Rendra macht diesen GET sicher, günstig und wiederholbar.
Jeder Abfrageparameter wird mit Ihrem Schlüssel per HMAC-SHA256 signiert, und jede URL läuft ab. Niemand kann durch das Ändern des Titels Ihre Credits verbrauchen.
Heute gibt es zwei Vorlagen: og_standard für dauerhafte Cards und announcement für Launches. Eigene Vorlagen stehen auf der Pro-Roadmap.
Identische Renderings kommen mit X-Cached: true kostenlos aus dem Cache zurück. Antworten bleiben bis zu 24 Stunden öffentlich und unveränderlich.
Melden Sie sich mit Google oder Magic Link an. Erstellen Sie benannte API-Schlüssel, widerrufen Sie einzelne Schlüssel und überwachen Sie die Nutzung Ihres Monatskontingents.
Ihr Generierungsverlauf liegt im Dashboard und unter /api/v1/dashboard/history, damit Sie sehen können, was wann veröffentlicht wurde.
Senden Sie einen Prompt per POST und fragen Sie anschließend das Bild ab. Eine Provider-Kette bietet automatisches Failover. Derzeit als Vorschau, noch nicht Bestandteil der folgenden Tarife.
Alles Folgende steht in der OpenAPI-Spezifikation unter /openapi.yaml.
Ein öffentlicher Aufruf mit Ihrer E-Mail-Adresse erstellt das Konto und gibt Schlüssel und ID zurück. Alternativ können Sie sich anmelden und benannte Schlüssel im Dashboard erstellen.
$ curl -X POST \
https://rendra.alphabros.eu/api/v1/users \
-H "Content-Type: application/json" \
-d '{"email": "you@example.com"}'
201 Created
{ "id": "…", "email": "you@example.com",
"api_key": "rendra_…", "plan": "free" }
Sortieren Sie die Abfrage, signieren Sie Pfad und Abfrage per HMAC-SHA256 mit Ihrem Schlüssel und hängen Sie sig als Schlüssel-ID, Punkt und hexadezimalen Digest an.
const path = "/i/og_standard";
const query = new URLSearchParams({
title: "Ship faster",
description: "Beautiful social cards…",
expires: String(Math.floor(Date.now() / 1000) + 3600),
});
query.sort();
// sig = keyId + "." + hmac(path+"?"+query)
Setzen Sie die URL in Ihr og:image-Tag. Crawler erhalten das PNG; eine falsche oder abgelaufene Signatur liefert 403, ein erschöpftes Kontingent 402.
GET /i/og_standard?title=…&expires=…&sig=…
200 OK
Content-Type: image/png
Cache-Control: public, max-age=86400, immutable
X-Cached: false
403 { "error": "Invalid or expired signature" }
402 { "error": "Credit limit exceeded" }
Rendern Sie serverseitig? Senden Sie POST /api/v1/render mit denselben Feldern template, data, width, height und format sowie Ihrem API-Schlüssel.
Ein Rendering entspricht einem Credit. Credits werden monatlich zurückgesetzt. Cache-Treffer werden nie gezählt.
Hobbyprojekte, Tests und kleine Blogs.
Unternehmen, Agenturen und stark frequentierte Blogs.
Zusätzliche Credits: 0,50 € je 10. Ungenutzte Credits werden nicht übertragen. 30 Tage Geld-zurück-Garantie.
50 Renderings pro Monat kostenlos. Signieren Sie die erste URL in der Zeit, die Sie zum Lesen der Spezifikation brauchen.
Kostenlosen API-Schlüssel anfordern