Documentation

Authentification

Créez une clé API depuis votre tableau de bord, puis envoyez-la dans le header X-API-Key :

curl -X POST https://shotforge.dev/api/v1/screenshot \
  -H "X-API-Key: sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}' --output shot.png

POST/api/v1/screenshot

Transforme une URL en PNG ou JPEG.

🔒 Pages authentifiées

Capturez des pages derrière une connexion. Envoyez un objet auth optionnel avec votre requête — les identifiants servent une fois en mémoire pour le rendu, jamais stockés ni loggés. Plan Starter et supérieur.

curl -X POST https://shotforge.dev/api/v1/screenshot \
  -H "X-API-Key: sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://app.example.com/dashboard",
    "auth": {
      "username": "you@example.com",
      "password": "secret",
      "type": "basic"
    }
  }' --output private-page.png

Sécurité : les identifiants transitent par TLS, ne vivent que le temps du rendu dans un contexte navigateur isolé, et sont détruits à sa fermeture. Ils n'apparaissent ni dans les logs, ni en base, ni dans l'historique (seule l'URL cible est enregistrée).

POST/api/v1/og-image

Génère une carte sociale 1200×630 (PNG).

template — raw (capture viewport historique) ou l’un des 60 identifiants de modèles composés. Les cartes composées font toujours 1200×630.

title, subtitle, brand — Titre (120 caractères), sous-titre (220) et marque (60) optionnels pour les modèles composés.

Créateur OG →

POST/api/v1/pdf

Transforme une URL en PDF. Plan Pro et supérieur. Champs: url, format (A4|A3|Letter|Legal), landscape, print_background.

Erreurs