Intégration stockage

AWS S3

Livrez captures, HTML, PDF et vidéos dans votre propre bucket AWS S3 après chaque job — via un accès inter-comptes sécurisé, sans stocker d’identifiants.

Cette page

AWS S3 — inter-comptes

Accordez à ScreenshotCenter l’écriture sur votre bucket via l’ACL AWS. Pas de clés API à stocker ni à faire tourner.

Également disponible

Compatible S3 — clé / secret

Fonctionne avec tout point de terminaison compatible S3 (Cloudflare R2, Wasabi, MinIO) avec votre propre clé et secret.

Comment ça marche

L’accès inter-comptes permet à ScreenshotCenter d’écrire dans votre bucket sans partager vos identifiants : vous accordez l’accès à notre ID canonique AWS via l’ACL du bucket.

1

Créer un bucket dans AWS

Dans la console AWS, créez un bucket S3 dans la région souhaitée. Laissez la propriété des objets compatible avec l’accès par ACL.
2
Accorder l’accès à notre ID canonique

Allez dans Permissions → Access Control List (ACL), cliquez sur Add account et saisissez l’ID canonique ScreenshotCenter :
```
877f5fce8118db233f7c1d7167b0ee8cbe9601e3b83000e7904d53706af361c9
```
Accordez les droits List objects et Write objects.
3

Créer l’application dans le tableau de bord

Dans ScreenshotCenter, allez dans Apps, choisissez AWS S3 (Cross-account), et saisissez le nom du bucket et la région optionnelle. Aucune clé d’accès requise.
4

Inclure l’ID d’application dans les requêtes

Ajoutez l’ID d’application au paramètre apps. Les sorties sont téléversées dès la fin du job.

Exemple simple

curl "https://api.screenshotcenter.com/api/v1/screenshot/create\
  ?key=YOUR_API_KEY\
  &url=https://example.com\
  &apps=my-aws-s3-app"

import { ScreenshotCenterClient } from 'screenshotcenter';

const client = new ScreenshotCenterClient(process.env.SCREENSHOTCENTER_API_KEY);

const shot = await client.screenshot.create('https://example.com', {
  apps: ['my-aws-s3-app'],
});

console.log(shot.apps[0].output_url); // S3 object URL

from screenshotcenter import ScreenshotCenterClient

client = ScreenshotCenterClient(api_key="YOUR_API_KEY")

shot = client.screenshot.create(
    "https://example.com",
    apps=["my-aws-s3-app"],
)

print(shot["apps"][0]["output_url"])  # S3 object URL

use ScreenshotCenter\Client;

$client = new Client(getenv('SCREENSHOTCENTER_API_KEY'));

$shot = $client->screenshot->create('https://example.com', [
    'apps' => ['my-aws-s3-app'],
]);

echo $shot['apps'][0]['output_url']; // S3 object URL

import (
    "fmt"
    sc "github.com/juliensobrier/screenshotcenter-go"
)

client := sc.New("YOUR_API_KEY")

shot, _ := client.Screenshot.Create("https://example.com", &sc.ScreenshotParams{
    Apps: []string{"my-aws-s3-app"},
})

fmt.Println(shot.Apps[0].OutputURL) // S3 object URL

require "screenshotcenter"

client = ScreenshotCenter::Client.new(ENV["SCREENSHOTCENTER_API_KEY"])

shot = client.screenshot.create("https://example.com",
  apps: ["my-aws-s3-app"],
)

puts shot["apps"][0]["output_url"] # S3 object URL

import io.screenshotcenter.ScreenshotCenterClient;
import io.screenshotcenter.models.*;
import java.util.List;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = new ScreenshotCenterClient("YOUR_API_KEY");

        var shot = client.screenshot().create("https://example.com",
            new ScreenshotParams()
                .apps(List.of("my-aws-s3-app")));

        System.out.println(shot.getApps().get(0).getOutputUrl()); // S3 object URL
    }
}

using ScreenshotCenter;

var client = new ScreenshotCenterClient("YOUR_API_KEY");

var shot = await client.Screenshot.CreateAsync("https://example.com", new ScreenshotParams {
    Apps = new[] { "my-aws-s3-app" },
});

Console.WriteLine(shot.Apps[0].OutputUrl); // S3 object URL

L’URL du fichier est renvoyée dans apps[].output_url à la fin du job.

Chemins de fichiers personnalisés

Utilisez un modèle de chemin pour nommer et organiser les fichiers dans le bucket :

screenshots/{domain}/{yyyy}{mm}{dd}-{id}.png

Variables : {id}, {domain}, {yyyy}, {mm}, {dd}, {shot}, {browser}, {country}.

Pourquoi l’inter-comptes ?

Pas de rotation de secrets

L’accès repose sur l’ACL du bucket, pas sur une clé IAM. Rien à faire expirer.

Moindre privilège

ScreenshotCenter ne peut écrire que dans le bucket que vous autorisez.

Vous possédez les données

Les sorties vont dans votre bucket. Révoquez l’accès en modifiant l’ACL à tout moment.

Pour commencer

1. Créez un bucket S3 et accordez l’écriture à l’ID canonique 877f5fce...361c9.
2. Dans le tableau de bord, allez dans Apps → Connect a new app → AWS S3 (Cross-account).
3. Saisissez le nom du bucket et un modèle de chemin optionnel, enregistrez et vérifiez.
4. Ajoutez l’ID d’application à vos requêtes de capture.

Commencer gratuitement Compatible S3 (clé/secret) Documentation API