URL firmadas y con caducidad
Cada parámetro de consulta se firma con HMAC-SHA256 usando tu clave y cada URL tiene caducidad. Nadie puede gastar tus créditos editando el título.
Rendra convierte una URL firmada en una tarjeta social de 1200×630. Elige una plantilla, pasa el título y la descripción como parámetros de consulta y fírmalos con tu clave API: los rastreadores reciben un PNG, almacenado en caché durante un día y facturado una sola vez. Una URL firmada se convierte en una tarjeta social de 1200×630. Elige una plantilla, pasa el título y la descripción y firma con tu clave API. Los rastreadores reciben un PNG, almacenado en caché durante un día y facturado una sola vez.
50 renderizados gratis al mes. Sin tarjeta. Inicia sesión con Google o un enlace mágico. 50 renderizados gratis al mes. Sin tarjeta.
// 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}`);
Los rastreadores sociales obtienen og:image con un GET simple. Rendra hace que ese GET sea seguro, económico y repetible.
Cada parámetro de consulta se firma con HMAC-SHA256 usando tu clave y cada URL tiene caducidad. Nadie puede gastar tus créditos editando el título.
Hoy hay dos plantillas: og_standard para tarjetas permanentes y announcement para lanzamientos. Las plantillas personalizadas están en la hoja de ruta de Pro.
Los renderizados idénticos vuelven de la caché con X-Cached: true y no cuestan nada. Las respuestas permanecen públicas e inmutables hasta 24 horas.
Inicia sesión con Google o un enlace mágico. Crea claves API con nombre, revoca una sin afectar a las demás y controla el uso de tu cuota mensual.
Tu historial de generación está en el panel y en /api/v1/dashboard/history, para que veas qué se publicó y cuándo.
Envía un prompt por POST y consulta después la imagen. Funciona con una cadena de proveedores y conmutación por error automática. Ahora en vista previa, todavía fuera de los planes siguientes.
Todo lo siguiente está en la especificación OpenAPI de /openapi.yaml.
Una llamada pública con tu correo crea la cuenta y devuelve la clave y su identificador. También puedes iniciar sesión y crear claves con nombre en el panel.
$ 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" }
Ordena la consulta, firma la ruta y la consulta con HMAC-SHA256 usando tu clave y añade sig como identificador de clave, un punto y el resumen hexadecimal.
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)
Pon la URL en tu etiqueta og:image. Los rastreadores reciben el PNG; una firma incorrecta o caducada devuelve 403 y una cuota agotada, 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" }
¿Renderizas en el servidor? Envía POST /api/v1/render con los mismos campos template, data, width, height y format, además de tu clave API.
Un renderizado equivale a un crédito. Los créditos se reinician cada mes. Los aciertos de caché nunca cuentan.
Proyectos personales, pruebas y blogs pequeños.
Empresas, agencias y blogs de alto tráfico.
Créditos adicionales: 0,50 € por cada 10. Los créditos no utilizados no se acumulan. Garantía de devolución de 30 días.
50 renderizados gratis al mes. Firma la primera URL en lo que tardas en leer la especificación.
Obtén tu clave API gratis