Dokumentation

API-Referenz

Verwaltete Dateien abfragen

GET/v1/files

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

Abfrageparameter

  • afterintegerOptional

    Verwenden Sie next_cursor aus der ursprünglichen Antwort; der Dienst legt 50 Einträge pro Seite fest.

    Standardwert
    0
    Minimum
    0

Antworten und Fehler

HTTP 200

Verwaltete Dateien erfolgreich abgefragt

application/json

Typ
object
Pflichtfelder
datanext_cursor
  • dataarrayErforderlich
    Unterfelder von data (1)
    • []objectOptional
      Unterfelder von [] (13)
      • 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.

  • next_cursorintegerErforderlich

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.