Anwendung – Snapshots
Snapshot erstellen
Erstellt einen Snapshot deiner Anwendung. Hat ein Rate-Limit von 1 Anfrage alle 5 Sekunden.
POST
Snapshot erstellen
Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren Kontoeinstellungen.
Parameter
Die ID der Anwendung. Du findest sie in der URL des Dashboards deiner Anwendung.
Verhalten bei Soft-Deadline
Diese Route folgt einem Soft-Deadline-Modell — sie antwortet nicht mehr immer synchron.- Wird der Snapshot innerhalb von ~90 Sekunden fertiggestellt, antwortet die Route mit
200 successund einer signierten Download-URL (30 Tage gültig), genau wie zuvor. - Dauert die Erstellung des Snapshots länger als ~90 Sekunden, antwortet die Route sofort mit
202und dem CodeSNAPSHOT_PROCESSING. Das ist kein Fehler. Der Snapshot wird im Hintergrund weiter erstellt und erscheint von selbst in der Snapshot-Auflistung, typischerweise innerhalb von ~2 Minuten. Dies ist erwartetes Verhalten für große Anwendungen.
| Antwort | Bedeutung | Was zu tun ist |
|---|---|---|
status === "success" | Snapshot ist bereit. | Verwende die url, um ihn herunterzuladen. |
status === "error" und code === "SNAPSHOT_PROCESSING" | Snapshot wird noch erstellt. | Warte ~2 Minuten und bestätige dann über Snapshots auflisten (GET). Führe keinen erneuten POST aus. |
status === "error" mit einem anderen code | Tatsächlicher Fehler. | Behandle den Fehler (siehe unten). |
Antwort
Gibt an, ob der Aufruf erfolgreich war.
success bei Erfolg, error andernfalls.Der Inhalt der Antwort. Nur vorhanden, wenn
status gleich success ist.Wird zurückgegeben, wenn der Snapshot die Soft-Deadline von ~90 Sekunden überschreitet. Der Snapshot wird weiterhin im Hintergrund erstellt und erscheint von selbst in der Snapshot-Auflistung, typischerweise innerhalb von ~2 Minuten. Kein Fehler — warte und bestätige über den
GET-Auflistungsendpoint.Fehler
Eine Snapshot-Anfrage kann mit429 Too Many Requests abgelehnt werden. Verwende das Feld code, um die beiden Fälle zu unterscheiden:
Kurzfristige Abkühlphase — du hast das Limit pro Nutzer (1 Anfrage / 5 s) oder pro Anwendung (1 Anfrage / 180 s) erreicht. Warte kurz und versuche es erneut.
Tageskontingent erreicht — das Konto hat das tägliche Snapshot-Kontingent seines Tarifs aufgebraucht ((RAM / 256) × 2 pro 24 h). Das Kontingent wird wieder frei, während das gleitende 24-Stunden-Fenster fortschreitet; für ein höheres Tageskontingent upgrade den Tarif.
Snapshot erstellen

