Applicazione - Snapshot
Crea Snapshot
Esegui uno snapshot della tua applicazione. 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 dell’applicazione. Puoi trovarlo nell’URL della dashboard della tua applicazione.
Comportamento con soft deadline
Questa route segue un modello a 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 impiega 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à da solo nell’elenco degli snapshot, tipicamente entro ~2 minuti. Questo è il comportamento atteso per le applicazioni 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 generazione. | Attendi ~2 minuti, poi conferma tramite List Snapshots (GET). Non rieseguire il POST. |
status === "error" con qualsiasi altro code | Fallimento 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 generazione in background e comparirà da solo nell’elenco degli snapshot, tipicamente 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 applicazione (1 richiesta / 180s). Attendi e riprova a breve.
Quota giornaliera raggiunta — l’account ha esaurito il numero di snapshot giornalieri consentiti dal suo piano ((RAM / 256) × 2 ogni 24h). La quota si libera man mano che la finestra mobile di 24 ore avanza; per un limite giornaliero più alto, effettua l’upgrade del piano.
Crea Snapshot

