Dokumentation

API-Referenz

Verwaltete Dateien abfragen

GET/v1/files/{file_id}

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.

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

Verwaltete Dateien erfolgreich abgefragt

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.