Dokumentation

API-Referenz

Dateiarchivierung erneut versuchen

POST/v1/files/{file_id}/retry

Historische Dateien desselben Kontos und Schlüssels. Gültige Schlüssel mit ausgeschöpftem Kontingent sind erlaubt; widerrufene/abgelaufene bleiben gesperrt. Downloads erfordern ready; Löschen bei vorhandenen Referenzen liefert 409. retry speichert nur das ursprüngliche Ergebnis erneut, ohne Neugenerierung. Gewöhnliche APIs verwenden eine Aufbewahrungsfrist in Tagen, persistente Aufgaben schützen Referenzen; expires_at=0 bedeutet kein festes Ablaufdatum.

Wiederherstellung nach Speicherfehlern

Prüfen Sie zuerst freien Speicherplatz und Fehlerursache. Dieser Vorgang reserviert erneut Speicherkapazität und archiviert das ursprüngliche Ergebnis, ohne den Generierungsanbieter erneut aufzurufen oder die ursprünglichen Aufgabenkosten zu ändern. Ist die Originalquelle abgelaufen, kann der erneute Versuch trotzdem scheitern.

Verwalten Sie durch persistente Aufgabenreferenzen geschützte Dateien über den Aufgabenlebenszyklus. Löschen Sie keine referenzierten Dateien, um Speicher freizugeben. Prüfen Sie Abrechnungs- und Speicherstatus getrennt; siehe Abrechnung.

Authentifizierung und Berechtigungen

Verwenden Sie Ihren aktuellen GloopAPI-Schlüssel. Verfügbare Modelle, Funktionen und Berechtigungen hängen von seinem Katalog und der Endpunktdokumentation ab.

Authorization: Bearer $GLOOP_API_KEY

Authentifizierungsschemata: BearerAuth

Anfrage

Pfadparameter

  • file_idstringErforderlich

    Öffentliche ID einer verwalteten Datei desselben Schlüssels.

Antworten und Fehler

HTTP 200

Erneuter Versuch der Dateiarchivierung erfolgreich angefordert

application/json

Typ
object
Pflichtfelder
idsource_kindsource_indexmodelstatusmime_typefile_namesize_bytescreated_atupdated_atexpires_at
  • idstringErforderlich

    Öffentliche Kennung dieses Objekts für den zugehörigen Detailpfad.

  • source_kindstringErforderlich

    Dateiquellkategorie; bestimmt Lebenszyklus und Referenzschutz.

  • source_indexintegerErforderlich

    Index des Quellergebnisses.

  • modelstringErforderlich

    Öffentliche Modell-ID aus dem Katalog des aktuellen Schlüssels.

  • statusstringErforderlich

    Hintergrund-Speicherphasen wie waiting/pending/archiving/ready/failed/deleting; Download-URL erst nach ready.

  • mime_typestringErforderlich

    Geprüfter MIME-Typ der Datei.

  • file_namestringErforderlich

    Öffentlicher Download-Dateiname.

  • sha256stringOptional

    SHA-256 des archivierten Inhalts, sofern bereits ermittelt.

  • size_bytesintegerErforderlich

    Dateigröße in Bytes.

  • error_codestringOptional

    Öffentlicher Fehlercode für Fallunterscheidungen.

  • created_atintegerErforderlich

    Erstellungszeit in Unix-Sekunden.

  • updated_atintegerErforderlich

    Letzte Aktualisierung in Unix-Sekunden.

  • expires_atintegerErforderlich

    Unix-Sekunden; 0 bedeutet Langzeitaufbewahrung. Normale APIs folgen der Deployment-Aufbewahrungsdauer; persistente Bild-/Videoreferenzen schützen Ergebnisse. Abrechnung und Idempotenz bleiben nach Löschung erhalten.

HTTP 400

Ungültige Anfragefelder oder Parameter.

application/json

Typ
object
Pflichtfelder
error

HTTP 401

Key fehlt, ist ungültig, abgelaufen oder widerrufen.

application/json

Typ
object
Pflichtfelder
error

HTTP 403

Unzureichende IP-, Konto-, Modell- oder Tool-Berechtigungen.

application/json

Typ
object
Pflichtfelder
error

HTTP 404

Objekt/Funktion nicht verfügbar oder Funktionsschalter deaktiviert.

application/json

Typ
object
Pflichtfelder
error

HTTP 409

Idempotenz-/Kostenvoranschlagskonflikt, Objekt nicht bereit oder noch referenziert.

application/json

Typ
object
Pflichtfelder
error

HTTP 429

Anfrage-/Warteschlangenlimit.

application/json

Typ
object
Pflichtfelder
error

HTTP 500

Interner Authentifizierungs- oder Datenspeicherungsfehler.

application/json

Typ
object
Pflichtfelder
error

HTTP 503

Dienst, Preisberechnung oder Speicherung nicht verfügbar.

application/json

Typ
object
Pflichtfelder
error
Bereit zum Entwickeln? Öffnen Sie Konsole um einen API-Schlüssel zu erstellen, oder durchsuchen Sie Funktionen.