Base de datos - Snapshots
Crear Snapshot
Realiza un snapshot de tu base de datos. Tiene un límite 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 base de datos.
Comportamiento de soft deadline
Esta ruta sigue un modelo de soft deadline — ya no siempre responde de forma síncrona.- Si el snapshot termina dentro de ~90 segundos, la ruta responde con
200 successy una URL de descarga firmada (válida durante 30 días), exactamente como antes. - Si el snapshot tarda más de ~90 segundos en generarse, la ruta responde inmediatamente con
202y el códigoSNAPSHOT_PROCESSING. Esto no es un fallo. El snapshot continúa generándose en segundo plano y aparecerá en el listado de snapshots por sí solo, normalmente en ~2 minutos. Este es el comportamiento esperado para bases de datos 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, luego confirma mediante List Snapshots (GET). No vuelvas a hacer POST. |
status === "error" con cualquier otro code | Fallo real. | Gestiona el error (ver más 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 aún se está generando en segundo plano y aparecerá en el listado de snapshots por sí solo, 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 — has alcanzado el límite por usuario (1 solicitud / 5s) o por base de datos (1 solicitud / 180s). Reduce la frecuencia y reintenta en breve.
Cuota diaria alcanzada — la cuenta agotó el límite diario de snapshots de su plan ((RAM / 256) × 2 por 24h). La cuota se libera a medida que avanza la ventana móvil de 24 horas; para un límite diario mayor, mejora el plan.
Crear Snapshot

