L'URL expose-t-elle ma clé API ?

Non. La clé crée l'URL et n'y figure jamais. L'URL porte les paramètres de la requête et une signature de ceux-ci : un visiteur ne peut pas modifier la cible, la taille ou le modèle et obtenir quand même un rendu.

Qui paie les rendus effectués via une URL signée ?

Le compte qui l'a créée. Un rendu via l'URL est décompté de l'utilisation de ce compte exactement comme un appel API direct, et une répétition servie depuis le cache ne compte pas.

L'URL peut-elle expirer ?

C'est vous qui choisissez. Sans durée de vie, elle vaut 30 jours ; définissez-en une en heures lors de la création, ou mettez-la à zéro pour une URL qui n'expire pas, ce qu'il vous faut pour une og:image qui doit continuer à fonctionner.

Que peut générer une URL signée ?

Une capture d'écran d'une URL, ou un modèle enregistré avec les variables que vous transmettez. Cela couvre les deux cas où le fichier doit exister à une URL : captures de pages et images générées.

Puis-je en utiliser une dans une balise og:image ?

Oui, c'est précisément le cas pour lequel la fonctionnalité existe. Les robots d'exploration récupèrent l'URL, Ironfang Render génère le rendu, et l'image est là sans que votre application ait rien généré ni stocké au préalable.

Puis-je en placer une dans une balise img ou un e-mail ?

Oui. C'est un simple GET HTTPS qui renvoie une image : tout ce qui charge une image peut la charger.

Mettez le rendu dans l'URL

Créez une URL Ironfang Render signée et utilisez-la directement dans une page, une balise og:image ou un e-mail. Le rendu a lieu à la première requête, puis est mis en cache : votre application ne génère, ne stocke et ne sert jamais le fichier elle-même.

Créer un compte gratuit Lire la documentation de l'API

Aucune clé dans le balisage
Aucun bucket temporaire
Les réponses en cache ne comptent pas
N'expire jamais, si vous le souhaitez

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.com/render/v1/
               results/0/8a13c09e4f22..." >

Ce qu'elle remplace

La plomberie de rendu que vous n'écrivez plus

Générer une image pour chaque page, c'est surtout de l'infrastructure. Une URL signée supprime l'infrastructure et garde l'image.

Sans elle

Faire tourner un worker de rendu, ou mettre une tâche en file et l'interroger
Écrire le résultat dans un endroit public et maintenir le bucket en vie
Invalider et régénérer quand le contenu sous-jacent change
Garder un secret d'API dans ce qui génère le balisage

Avec une URL signée

Créer une URL signée une seule fois, depuis votre serveur
La placer dans le balisage, la balise ou l'e-mail
Ironfang Render effectue le rendu au premier GET et sert le reste depuis le cache
Aucune clé dans la page, aucun bucket, aucun worker

Comment ça marche

Signée une fois, rendue à la demande

Votre serveur détient la clé. La page contient une URL impossible à falsifier.

Votre serveur crée une URL

L'URL va dans le balisage

Ironfang Render effectue le rendu au GET

La signature couvre les paramètres : la cible, la taille et le modèle ne peuvent pas être modifiés par quiconque détient le lien.
Le premier GET déclenche le rendu. Un GET identique servi depuis le cache ne compte pas ; un GET qui déclenche un nouveau rendu compte comme n'importe quel rendu.
Les rendus sont décomptés du compte qui a créé l'URL, dans la même limite d'utilisation mensuelle que le reste de votre utilisation.

Où elle s'intègre

Deux types, et les endroits où ils ont leur place

Une URL signée génère une capture de page ou un modèle enregistré. Ce sont les deux types de fichiers qui doivent généralement exister à une URL.

Open Graph et cartes sociales

Concevez un modèle, créez une URL par page avec le titre, l'auteur ou le prix comme variables, et placez-la directement dans la balise og:image. Modifiez le modèle et chaque carte suit, sans reconstruction ni cache à purger.

Le rendu de modèles dans la documentation

Des captures de page sur place

Intégrez une capture en direct d'une page dans un tableau de bord, un écran d'état, un e-mail récapitulatif ou un annuaire. L'image est à jour au moment où elle est récupérée, et non aussi fraîche que votre dernière exécution cron.

Voir aussi l'API de codes QR

Questions

Avant de vous lancer

Les détails qui décident si la solution vous convient, sans lire d'abord toute la référence.

L'URL expose-t-elle ma clé API ?: Non. La clé crée l'URL et n'y figure jamais. L'URL porte les paramètres de la requête et une signature de ceux-ci : un visiteur ne peut pas modifier la cible, la taille ou le modèle et obtenir quand même un rendu.
Qui paie les rendus effectués via une URL signée ?: Le compte qui l'a créée. Un rendu via l'URL est décompté de l'utilisation de ce compte exactement comme un appel API direct, et une répétition servie depuis le cache ne compte pas.
L'URL peut-elle expirer ?: C'est vous qui choisissez. Sans durée de vie, elle vaut 30 jours ; définissez-en une en heures lors de la création, ou mettez-la à zéro pour une URL qui n'expire pas, ce qu'il vous faut pour une og:image qui doit continuer à fonctionner.
Que peut générer une URL signée ?: Une capture d'écran d'une URL, ou un modèle enregistré avec les variables que vous transmettez. Cela couvre les deux cas où le fichier doit exister à une URL : captures de pages et images générées.
Puis-je en utiliser une dans une balise og:image ?: Oui, c'est précisément le cas pour lequel la fonctionnalité existe. Les robots d'exploration récupèrent l'URL, Ironfang Render génère le rendu, et l'image est là sans que votre application ait rien généré ni stocké au préalable.
Puis-je en placer une dans une balise img ou un e-mail ?: Oui. C'est un simple GET HTTPS qui renvoie une image : tout ce qui charge une image peut la charger.

Moins à exploiter. Plus à livrer.

Créez votre première URL signée

Créez un compte, récupérez une clé et signez une requête. Le rendu tient dans votre quota gratuit.

Créer un compte gratuit Lire la référence de l'API

500 captures d'écran gratuites chaque mois, sans carte, et les réponses en cache ne comptent pas.