HTML vers image

Capturez l'URL d'une page web ou un contenu HTML brut sous forme d'image de capture d'écran. Prend en charge l'émulation d'appareil (ordinateur, tablette, mobile), la capture de page entière et plusieurs formats de sortie.

Point de terminaison de l'API

POST /api/v1/tools/image/html-to-image

Accepte un corps JSON (pas de multipart). Aucun téléversement de fichier n'est nécessaire.

Paramètres

Paramètre	Type	Requis	Par défaut	Description
url	string	Conditionnel	-	URL à capturer (doit être une URL valide)
html	string	Conditionnel	-	Contenu HTML brut à rendre (1 à 5 000 000 caractères)
format	string	Non	"png"	Format de sortie : jpg, png, webp
quality	number	Non	90	Qualité de sortie pour les formats avec perte (1 à 100)
fullPage	boolean	Non	false	Capturer la page entière défilable, pas seulement la fenêtre d'affichage
devicePreset	string	Non	"desktop"	Émulation d'appareil : desktop, tablet, mobile, custom
viewportWidth	number	Non	1280	Largeur personnalisée de la fenêtre d'affichage en pixels (320 à 3840, utilisée quand devicePreset vaut custom)
viewportHeight	number	Non	720	Hauteur personnalisée de la fenêtre d'affichage en pixels (320 à 2160, utilisée quand devicePreset vaut custom)

Soit url, soit html doit être fourni, mais pas les deux.

Préréglages d'appareil

Préréglage	Largeur	Hauteur	UA mobile
desktop	1280	720	Non
tablet	768	1024	Non
mobile	375	812	Oui
custom	(défini par l'utilisateur)	(défini par l'utilisateur)	Non

Exemple de requête

Capturer une page web :

curl -X POST http://localhost:1349/api/v1/tools/image/html-to-image \
  -H "Authorization: Bearer si_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "format": "png", "fullPage": true, "devicePreset": "desktop"}'

Rendre un contenu HTML :

curl -X POST http://localhost:1349/api/v1/tools/image/html-to-image \
  -H "Authorization: Bearer si_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"html": "<div style=\"padding: 20px; background: #f0f0f0;\"><h1>Hello</h1></div>", "format": "png"}'

Exemple de réponse

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/screenshot.png",
  "originalSize": 0,
  "processedSize": 145000
}

Notes

• Nécessite que Chromium soit installé sur le serveur. Renvoie HTTP 503 si le service de navigateur n'est pas disponible.
• Les URL sont validées contre les attaques SSRF (les adresses de réseau privé/interne sont bloquées).
• Ce point de terminaison est limité à 120 requêtes par heure.
• originalSize vaut toujours 0 puisque cet outil génère des images à partir d'URL/HTML.
• Le nom du fichier de sortie est screenshot.<format>.
• Si la page met trop de temps à charger, la requête renvoie HTTP 504 (délai d'attente de la passerelle dépassé).
• Si le service de navigateur plante à répétition, il est temporairement désactivé et renvoie HTTP 503 avec le code BROWSER_CRASHED.