Aplicación - Snapshots
Crear snapshot
Realiza un snapshot de tu aplicación. Tiene un límite de tasa de 1 solicitud cada 5 segundos.
POST
Crear snapshot
La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.
Parámetros
El ID de la aplicación. Puedes encontrarlo en la URL del panel de tu aplicación.
Comportamiento de soft deadline
Esta ruta sigue un modelo de soft deadline: ya no siempre responde de forma síncrona.- Si el snapshot termina en ~90 segundos, la ruta responde con
200 successy una URL de descarga firmada (válida por 30 días), exactamente como antes. - Si el snapshot tarda más de ~90 segundos en generarse, la ruta responde de inmediato con
202y el códigoSNAPSHOT_PROCESSING. Esto no es un fallo. El snapshot sigue generándose en segundo plano y aparecerá por sí solo en el listado de snapshots, normalmente en ~2 minutos. Este es el comportamiento esperado para aplicaciones grandes.
| Respuesta | Significado | Qué hacer |
|---|---|---|
status === "success" | El snapshot está listo. | Usa la url para descargarlo. |
status === "error" y code === "SNAPSHOT_PROCESSING" | El snapshot aún se está generando. | Espera ~2 minutos y luego confirma mediante Listar snapshots (GET). No vuelvas a hacer POST. |
status === "error" con cualquier otro code | Fallo real. | Maneja el error (ver abajo). |
Respuesta
Indica si la llamada fue exitosa.
success si fue exitosa, error si no.El contenido de la respuesta. Presente solo cuando
status es success.Se devuelve cuando el snapshot supera el soft deadline de ~90 segundos. El snapshot sigue generándose en segundo plano y aparecerá por sí solo en el listado de snapshots, normalmente en ~2 minutos. No es un error: espera y confirma mediante el endpoint de listado
GET.Errores
Una solicitud de snapshot puede ser rechazada con429 Too Many Requests. Usa el campo code para distinguir los dos casos:
Enfriamiento a corto plazo: alcanzaste el límite por usuario (1 solicitud / 5 s) o por aplicación (1 solicitud / 180 s). Espera un poco y reintenta en breve.
Cuota diaria alcanzada: la cuenta agotó la asignación diaria de snapshots de su plan ((RAM / 256) × 2 por cada 24 h). La cuota se libera a medida que avanza la ventana móvil de 24 horas; para una asignación diaria mayor, mejora el plan.
Crear snapshot

