Documentation de l'API Callback (MB)

L'API Callback permet d'héberger les captures d'écran sur vos propres serveurs. Contrairement à l'API standard, les vignettes ne sont pas stockées sur les serveurs Shotbot, mais sont automatiquement envoyées vers votre serveur, une fois générées.

Schéma de fonctionnement:
1. - Votre serveur envoie une demande de création de vignette, en spécifiant une adresse de retour (Callback)
2. - Nos serveurs génèrent la capture d'écran
3. - La vignette est envoyée sur votre serveur, via une requête HTTP-POST sur l'adresse de retour (Callback)

Exemple d'implémentation avec PHP/Curl:

// adresse à capturer $_uri = urlencode('http://adresse.à.capturer/'); // adresse de callback $_uri_callback = urlencode('http://adresse.de/callback.php'); $_k = '************'; // clé webmaster $_s = '120'; // format de la capture (80, 92, 120, etc.) $_t = '10'; // timeout de chargement du site à capturer (de 3 à 30 secondes) $_nojs = '0'; // activer/désactiver javascript (0/1) // ne pas modifier $POSTURL = 'https://add.shotbot.net/callback.php'; $POSTVARS = 'k=' . $_k . '&uri=' . $_uri . '&s=' . $_s . '&t=' . $_t . '&uri_callback=' . $_uri_callback . '&nojs=' . $_nojs; $ch = curl_init($POSTURL); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $POSTVARS); curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1); curl_setopt($ch, CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); $_out = curl_exec($ch); echo $_out; curl_close($ch);

Le serveur renverra une réponse de type "OK $id". La variable $id est unique à chaque demande de création, et est renvoyée lors du callback. En cas d'erreur, le serveur se conforme aux codes retour API standards shotbot.

Une fois la capture générée, une requête POST est automatiquement effectuée sur l'adresse de Callback spécifiée lors de la requête de création.
Exemple de données reçues avec PHP:

Attention, afin d'éviter un engorgement inutile des files d'attente, votre script de callback doit répondre dans un délai maximal de 30 secondes.