Démarrage rapide cURL pour l'API ScreenshotCenter | ScreenshotCenter

Prérequis

• Un compte ScreenshotCenter avec une clé API (obtenez-en une gratuitement sur inscription).
• curl installé (pré-installé sur macOS et la plupart des distributions Linux ; sous Windows, utilisez Git Bash ou WSL).

Authentification

Chaque requête nécessite votre clé API. Vous pouvez la passer en header ou en paramètre de requête :

# Header (recommandé)
-H "X-API-KEY: VOTRE_CLE_API"

# Paramètre de requête
?key=VOTRE_CLE_API

Stockez votre clé dans une variable d'environnement :

export SCREENSHOTCENTER_API_KEY="votre-cle-ici"

Documentation complète : guide d'authentification API.

Votre première capture

curl -X POST https://api.screenshotcenter.com/v1/screenshot \
  -H "X-API-KEY: $SCREENSHOTCENTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "format": "png",
    "size": "screen"
  }'

Cela retourne une réponse JSON avec l'ID de la capture et son statut.

Vérifier le statut et télécharger

# Vérifier le statut
curl "https://api.screenshotcenter.com/api/v1/screenshot/info?key=$SCREENSHOTCENTER_API_KEY&id=SCREENSHOT_ID"

# Télécharger l'image
curl -o screenshot.png "https://api.screenshotcenter.com/api/v1/screenshot/thumbnail?key=$SCREENSHOTCENTER_API_KEY&id=SCREENSHOT_ID"

Générer un PDF

Changez format en pdf pour un document PDF pleine page :

curl -X POST https://api.screenshotcenter.com/v1/screenshot \
  -H "X-API-KEY: $SCREENSHOTCENTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "format": "pdf",
    "size": "page"
  }'

Apprenez-en plus sur les options PDF dans la référence de l'API de génération PDF.

Options courantes

Paramètre	Exemple	Effet
size	"page"	Capture pleine page (scroll jusqu'en bas)
width	1920	Largeur du viewport en pixels
country	"gb"	Rendu depuis un navigateur UK
delay	3000	Attendre 3 secondes avant la capture
hide_popup	true	Supprimer les bannières de cookies
wait_for	".main-content"	Attendre qu'un sélecteur CSS apparaisse

Gestion des erreurs

L'API retourne des codes de statut HTTP standard :

• 200 — Succès. Vérifiez le champ data.status.
• 400 — Requête invalide. Paramètres manquants ou incorrects.
• 401 — Clé API invalide.
• 429 — Limite de débit. Attendez et réessayez.

curl -s -X POST https://api.screenshotcenter.com/v1/screenshot \
  -H "X-API-KEY: $SCREENSHOTCENTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "format": "png"}' \
  | jq '.success, .data.id, .data.status'

Prochaines étapes

• Explorez la documentation API complète pour tous les paramètres et endpoints.
• Essayez un SDK : JavaScript, Python, Go, PHP, Java.
• Configurez la livraison S3 et les webhooks pour des workflows automatisés.

FAQ

Dois-je installer autre chose que cURL ?

Non. cURL et une clé API valide suffisent pour commencer à prendre des captures.

Peut-on utiliser cURL dans les pipelines CI/CD ?

Oui. cURL fonctionne dans tout environnement shell — GitHub Actions, GitLab CI, Jenkins et scripts locaux.

Quelle est la limite de débit ?

Cela dépend de votre plan. Les plans gratuits autorisent 5 requêtes concurrentes. Les plans payants montent en puissance. Consultez votre tableau de bord pour les limites actuelles.

Copiez l'exemple ci-dessus et explorez l'API complète.