Database - Snapshot
Crea Snapshot
Esegui uno snapshot del tuo database. Ha un limite di frequenza di 1 richiesta ogni 5 secondi.
POST
Crea Snapshot
La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.
Parametri
L’ID del database.
Comportamento con soft deadline
Questa route segue un modello di soft deadline — non risponde più sempre in modo sincrono.- Se lo snapshot termina entro ~90 secondi, la route risponde con
200 successe un URL di download firmato (valido per 30 giorni), esattamente come prima. - Se lo snapshot richiede più di ~90 secondi per essere generato, la route risponde immediatamente con
202e il codiceSNAPSHOT_PROCESSING. Questo non è un errore. Lo snapshot continua a essere generato in background e comparirà nell’elenco degli snapshot autonomamente, di solito entro ~2 minuti. Questo è il comportamento previsto per database di grandi dimensioni.
| Risposta | Significato | Cosa fare |
|---|---|---|
status === "success" | Lo snapshot è pronto. | Usa l’url per scaricarlo. |
status === "error" e code === "SNAPSHOT_PROCESSING" | Lo snapshot è ancora in fase di generazione. | Attendi ~2 minuti, poi conferma tramite List Snapshots (GET). Non rieseguire il POST. |
status === "error" con qualsiasi altro code | Errore effettivo. | Gestisci l’errore (vedi sotto). |
Risposta
Indica se la chiamata è andata a buon fine.
success in caso di successo, error in caso contrario.Il contenuto della risposta. Presente solo quando
status è success.Restituito quando lo snapshot supera la soft deadline di ~90 secondi. Lo snapshot è ancora in fase di generazione in background e comparirà nell’elenco degli snapshot autonomamente, di solito entro ~2 minuti. Non è un errore — attendi e conferma tramite l’endpoint di elenco
GET.Errori
Una richiesta di snapshot può essere rifiutata con429 Too Many Requests. Usa il campo code per distinguere i due casi:
Cooldown a breve termine — hai raggiunto il limite per utente (1 richiesta / 5s) o per database (1 richiesta / 180s). Attendi e riprova a breve.
Quota giornaliera raggiunta — l’account ha esaurito la quota giornaliera di snapshot del proprio piano ((RAM / 256) × 2 per 24h). La quota si libera man mano che la finestra mobile di 24 ore avanza; per una quota giornaliera più alta, effettua l’upgrade del piano.
Crea Snapshot

