Référence API

POST https://api.shotbot.net/capture/callback
Content-Type: application/json

{
  "key":             "votre_clé_api",
  "url":             "https://test.shotbot.fr",
  "callback_url":    "https://votre-site.com/shotbot-callback.php",
  "callback_secret": "un-secret-aléatoire",
  "format":          "webp",
  "viewport_width":  1280,
  "ratio":           "16:9"
}

{ "token": "a3f1c9…", "status": "queued", "eta_seconds": 20 }

$_POST["token"]          → token 32 chars alphanumériques (identifiant unique de la capture)
$_POST["url"]             → URL originale capturée
$_POST["status"]          → "OK" | "ERR"
$_POST["format"]          → format de l'image (jpg, webp, etc.)
$_POST["callback_secret"] → secret renvoyé tel quel (uniquement si fourni à la création)
$_FILES["file"]           → image binaire (taille et format demandés)

// Pas d'aperçu en mode callback, une seule image au format choisi.

<?php
// submit-capture.php, côté client
$ch = curl_init("https://api.shotbot.net/capture/callback");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ["Content-Type: application/json"],
    CURLOPT_POSTFIELDS     => json_encode([
        "key"             => "VOTRE_CLÉ_API",
        "url"             => "https://test.shotbot.fr",
        "callback_url"    => "https://votre-site.com/shotbot-callback.php",
        "callback_secret" => "un-secret-aléatoire",
        "format"          => "webp",
        "viewport_width"  => 1280,
        "ratio"           => "16:9",
    ]),
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
echo "Capture : " . $res["token"];

<?php
// shotbot-callback.php, reçoit la capture
$EXPECTED_SECRET = "un-secret-aléatoire"; // identique à callback_secret envoyé

if (!hash_equals($EXPECTED_SECRET, $_POST["callback_secret"] ?? "")) {
    http_response_code(403);
    exit;
}

if (($_POST["status"] ?? "") !== "OK") {
    http_response_code(200);
    exit;
}

$token = preg_replace("/[^A-Za-z0-9]/", "", $_POST["token"] ?? "");
$format = in_array($_POST["format"] ?? "", ["jpg","png","webp","avif"])
        ? $_POST["format"] : "jpg";

if (!$token || !isset($_FILES["file"])) {
    http_response_code(400);
    exit;
}

$dest = __DIR__ . "/shots/" . $token . "." . $format;
move_uploaded_file($_FILES["file"]["tmp_name"], $dest);

http_response_code(200);
echo "OK";

POST https://api.shotbot.net/capture/batch
Content-Type: application/json

{
  "key":  "votre_clé_api",

  "jobs": [
    { "url": "https://test.shotbot.fr" },
    { "url": "https://other.com", "format": "png", "viewport_width": 390 }
  ],

  // Options globales, appliquées à toutes les captures, surchargeables individuellement
  "format":         "webp",
  "viewport_width": 1280,
  "ratio":          "16:9"
}

{
  "submitted":    2,
  "waitlisted":   0,
  "deduplicated": 0,
  "errors":       0,
  "jobs": [
    { "index": 0, "url": "https://test.shotbot.fr", "token": "a3f1c9…", "status": "queued" },
    { "index": 1, "url": "https://other.com",   "token": "b7e2d4…", "status": "queued" }
  ]
}

<?php
$api_key = "VOTRE_CLÉ_API";

$urls = [
    "https://test.shotbot.fr",
    "https://github.com",
    "https://wikipedia.org",
    // ... jusqu'à 500
];

// Soumettre le batch
$ch = curl_init("https://api.shotbot.net/capture/batch");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ["Content-Type: application/json"],
    CURLOPT_POSTFIELDS     => json_encode([
        "key"            => $api_key,
        "format"         => "webp",
        "viewport_width" => 1280,
        "ratio"          => "16:9",
        "jobs"           => array_map(fn($u) => ["url" => $u], $urls),
    ]),
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

echo "Soumis : {$res['submitted']} · File d'attente : {$res['waitlisted']}\n";

// Collecter les tokens des captures créées
$tokens = [];
foreach ($res["jobs"] as $capture) {
    if (isset($capture["token"])) {
        $tokens[$capture["url"]] = $capture["token"];
    }
}

// Attendre et afficher les résultats
foreach ($tokens as $url => $token) {
    do {
        sleep(3);
        $status = json_decode(file_get_contents(
            "https://api.shotbot.net/capture/" . $token
        ), true);
    } while (($status["status"] ?? "") !== "done");

    echo $url . " → " . $status["image"] . "\n";
}

https://update.shotbot.net/k={CLÉ}/[options/]{URL}
// Mêmes paramètres que add | re-capture sans déduplication

https://status.shotbot.net/k={CLÉ}
// → "OK 500:327:5000"  (quota:utilisé:réserve)