URL firmati e con scadenza
Ogni parametro di query è firmato con HMAC-SHA256 usando la tua chiave e ogni URL ha una scadenza. Nessuno può spendere i tuoi crediti modificando il titolo.
Rendra trasforma un URL firmato in una social card 1200×630. Scegli un modello, passa titolo e descrizione come parametri di query e firmali con la tua chiave API: i crawler ricevono un PNG, memorizzato nella cache per un giorno e fatturato una sola volta. Un URL firmato diventa una social card 1200×630. Scegli un modello, passa titolo e descrizione e firma con la tua chiave API. I crawler ricevono un PNG, memorizzato nella cache per un giorno e fatturato una sola volta.
50 rendering gratuiti al mese. Nessuna carta. Accedi con Google o un magic link. 50 rendering gratuiti al mese. Nessuna carta.
// 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}`);
I crawler social recuperano og:image con una semplice GET. Rendra rende quella GET sicura, economica e ripetibile.
Ogni parametro di query è firmato con HMAC-SHA256 usando la tua chiave e ogni URL ha una scadenza. Nessuno può spendere i tuoi crediti modificando il titolo.
Oggi sono disponibili due modelli: og_standard per le card sempreverdi e announcement per i lanci. I modelli personalizzati sono nella roadmap Pro.
I rendering identici tornano dalla cache con X-Cached: true e non costano nulla. Le risposte rimangono pubbliche e immutabili fino a 24 ore.
Accedi con Google o un magic link. Crea chiavi API con nome, revocane una senza toccare le altre e controlla l’utilizzo rispetto alla quota mensile.
La cronologia delle generazioni è disponibile nella dashboard e su /api/v1/dashboard/history, così puoi vedere cosa è stato pubblicato e quando.
Invia un prompt tramite POST, quindi controlla l’immagine. Una catena di provider offre failover automatico. Ora in anteprima, non ancora incluso nei piani seguenti.
Tutto ciò che segue è nella specifica OpenAPI su /openapi.yaml.
Una chiamata pubblica con la tua e-mail crea l’account e restituisce la chiave e il relativo ID. In alternativa, accedi e crea chiavi con nome nella dashboard.
$ 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" }
Ordina la query, firma percorso e query con HMAC-SHA256 usando la chiave, quindi aggiungi sig come ID della chiave, un punto e il digest esadecimale.
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)
Inserisci l’URL nel tag og:image. I crawler ricevono il PNG; una firma errata o scaduta restituisce 403 e una quota esaurita restituisce 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" }
Esegui il rendering lato server? Invia POST /api/v1/render con gli stessi campi template, data, width, height e format, oltre alla tua chiave API.
Un rendering equivale a un credito. I crediti si azzerano ogni mese. Gli accessi alla cache non vengono mai conteggiati.
Progetti personali, test e piccoli blog.
Aziende, agenzie e blog ad alto traffico.
Crediti extra: 0,50 € ogni 10. I crediti inutilizzati non vengono trasferiti. Garanzia di rimborso di 30 giorni.
50 rendering gratuiti al mese. Firma il primo URL nel tempo necessario a leggere la specifica.
Ottieni la tua chiave API gratuita