Les cartes Open Graph partagent souvent une même mise en page, tandis que le titre et d'autres contenus changent d'une page à l'autre. Enregistrez la mise en page comme modèle, puis utilisez des URL signées pour fournir les variables de chaque page. Ironfang Render se charge de générer et de diffuser les images : votre application n'a ni à créer ni à stocker de fichiers image.
Enregistrer la carte une seule fois
Les modèles sont du HTML avec des {{ espaces réservés }}. Tout ce qu'un navigateur sait afficher fonctionne, y compris les polices web et les dégradés CSS.
Créer le modèle réutilisable.
curl -X POST https://api.ironfang.uk/render/v1/templates \
-H "Authorization: Bearer if_live_..." \
-H "Content-Type: application/json" \
-d '{
"name": "og-card",
"html": "<body style=\"background:#0a0a0f;color:#fff;font:700 64px sans-serif;padding:80px\">{{title}}</body>",
"width": 1200,
"height": 630
}'1200 × 630 est une taille d'image Open Graph largement prise en charge. La réponse contient l'ID du modèle, utilisé dans la requête suivante.
Créer une URL par page
Une URL signée contient les variables et une signature, ce qui permet de la rendre publique sans exposer votre clé API. Définissez ttl_hours à 0 pour créer une URL sans expiration, adaptée à une balise meta que les robots d'exploration pourront consulter de nouveau plus tard.
curl -X POST https://api.ironfang.uk/render/v1/sign \
-H "Authorization: Bearer if_live_..." \
-H "Content-Type: application/json" \
-d '{
"kind": "image",
"template": "TEMPLATE_ID",
"vars": { "title": "Reliable screenshots in CI" },
"ttl_hours": 0
}'L'intégrer dans la page
<meta property="og:image" content="https://api.ironfang.uk/render/v1/r/0/a1b2...">
<meta name="twitter:card" content="summary_large_image">Les robots des réseaux sociaux demandent l'URL signée directement à Ironfang Render : votre serveur d'application ne génère ni ne sert l'image. Le premier rendu consomme le quota de crédits habituel, tandis que les requêtes identiques servies depuis le cache sont gratuites.
Mettre à jour le design de façon centralisée
La génération des images reste ainsi liée au modèle actuel, et vous n'avez plus à rechercher, remplacer et stocker les fichiers générés auparavant après un changement de design.