Shotbot

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)

Créer une capture - Demande de création - Client

Exemple d'implémentation avec PHP/Curl:

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.

Callback - Serveur

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.