Dokumentation

API-Referenz

Kurzzeitig gültige Datei-Download-URL abrufen

GET/v1/files/{file_id}/download-url

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.

Wiedergabe und Download

Lesen Sie zuerst den Dateistatus und fordern Sie dann eine kurzlebige Download-URL an. Solange der Speicher nicht ready ist, macht eine URL die Datei nicht früher verfügbar. Senden Sie die ursprüngliche Key nur an GloopAPI und nicht beim Download von der zurückgegebenen HTTPS-Adresse.

Persistente Videos verwenden kurzlebige Objektspeicher-URLs für native Range-Wiedergabe. Ein vollständiges GET des normalen Video-content-Pfads verwendet einen anderen Transport. Fordern Sie nach Linkablauf eine neue URL an. Abgelaufene oder gelöschte Dateien werden durch Aktualisieren des Links nicht wiederhergestellt.

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

Kurzzeitig gültige Datei-Download-URL erfolgreich abgerufen

application/json

Typ
object
Pflichtfelder
urlexpires_at
  • urlstringErforderlich

    Kurzzeitig gültige signierte Download-URL; nicht offenlegen oder langfristig speichern.

    Format
    "uri"
  • expires_atintegerErforderlich

    Unix-Sekunden.

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.