Base de données - Snapshots
Créer un snapshot
Effectuer un snapshot de votre base de données. Limité à 1 requête toutes les 5 secondes.
POST
Créer un snapshot
La clé d’API de votre compte. Vous pouvez la trouver dans les paramètres de votre compte.
Paramètres
L’ID de la base de données.
Comportement du délai souple (soft deadline)
Cette route suit un modèle de délai souple — elle ne répond plus toujours de manière synchrone.- Si le snapshot se termine en ~90 secondes, la route répond avec
200 successet une URL de téléchargement signée (valable 30 jours), exactement comme avant. - Si le snapshot met plus de ~90 secondes à être généré, la route répond immédiatement avec
202et le codeSNAPSHOT_PROCESSING. Ce n’est pas un échec. Le snapshot continue d’être généré en arrière-plan et apparaîtra de lui-même dans la liste des snapshots, généralement en ~2 minutes. C’est le comportement attendu pour les grandes bases de données.
| Réponse | Signification | Que faire |
|---|---|---|
status === "success" | Le snapshot est prêt. | Utilisez l’url pour le télécharger. |
status === "error" et code === "SNAPSHOT_PROCESSING" | Le snapshot est toujours en cours de génération. | Attendez ~2 minutes, puis vérifiez via List Snapshots (GET). Ne relancez pas de POST. |
status === "error" avec tout autre code | Échec réel. | Traitez l’erreur (voir ci-dessous). |
Réponse
Indique si l’appel a réussi.
success en cas de succès, error sinon.Le contenu de la réponse. Présent uniquement lorsque
status vaut success.Retourné lorsque le snapshot dépasse le délai souple de ~90 secondes. Le snapshot est toujours en cours de génération en arrière-plan et apparaîtra de lui-même dans la liste des snapshots, généralement en ~2 minutes. Ce n’est pas une erreur — attendez et vérifiez via l’endpoint de liste
GET.Erreurs
Une requête de snapshot peut être rejetée avec429 Too Many Requests. Utilisez le champ code pour distinguer les deux cas :
Cooldown à court terme — vous avez atteint la limite par utilisateur (1 requête / 5s) ou par base de données (1 requête / 180s). Patientez et réessayez sous peu.
Quota journalier atteint — le compte a épuisé le quota journalier de snapshots de son plan ((RAM / 256) × 2 par 24h). Le quota se libère au fur et à mesure que la fenêtre glissante de 24 heures avance ; pour un quota journalier plus élevé, améliorez le plan.
Créer un snapshot

