So funktionieren lokale und Remote-Uploads
So funktionieren lokale und Remote-Uploads
In diesem Leitfaden wird der vollständige Fluss zum Hochladen von Dateien mit der Frame.io V4-API beschrieben.Erklärt werden die rohen API-Anfragen und -Antworten sowohl für lokale als auch für Remote-Uploads.
**Suchen Sie nach SDK-spezifischen Leitfäden?**Informationen zu Upload-Implementierungen mit integriertem Chunking, Wiederholungsversuchen und Tracking des Fortschritts finden Sie im Python SDK Upload-Leitfaden.
Voraussetzungen
Bevor Sie mit dem Hochladen von Dateien beginnen, vergewissern Sie sich, dass Sie diese Setup-Schritte abgeschlossen haben:
Frame.io V4-Konto
Sie haben ein Frame.io V4-Konto, das über die Adobe Admin Console verwaltet wird, ODER Sie haben für Ihren Kontobenutzer bzw. Ihre Kontobenutzerin zur Adobe-Authentifizierung gewechselt.
Setup der Adobe Developer Console
Sie haben sich bei der Adobe Developer Console angemeldet und die Frame.io-API zu einem neuen oder bestehenden Projekt hinzugefügt.
Authentifizierungsdaten
Sie haben die entsprechenden Authentifizierungsdaten für Ihr Projekt generiert.
Auswahl Ihrer Upload-Methode
Es gibt zwei Möglichkeiten, eine Datei mit der Frame.io-API hochzuladen: Datei erstellen (lokal hochladen) und Datei erstellen (Remote-Upload).
Diese Methode wird genutzt, wenn die Medien für Ihre Anwendung lokal zugänglich sind, ähnlich wie beim Ziehen einer Datei vom Desktop.
Diese Methode wird verwendet, wenn über das Netzwerk auf die Medien zugegriffen wird, beispielsweise durch .eine Integration mit einem anderen Service
In diesem Leitfaden beginnen wir mit dem einfacheren Fall des Abschließens eines Remote-Uploads.
Remote-Upload
Wählen Sie den Endpunkt Datei erstellen (Remote-Upload), um eine Datei über Remote-Upload zu erstellen.Für den Anfragefließtext wird der Dateiname und seine Quell-URL benötigt.
Für den Remote-Upload besteht derzeit ein Dateigrößen-Limit von 50 GB.Nutzen Sie bei Dateien von mehr als 50 GB stattdessen den lokalen Upload.
Anfragebeispiel
Antwortbeispiel
Eine erfolgreiche Anfrage führt zu einer Antwort wie der unten gezeigten:
Lokaler Upload
Wählen Sie den Endpunkt Datei erstellen (lokal hochladen), um eine Datei über den lokalen Upload zu erstellen.Für den Anfragefließtext werden der Dateiname und die Dateigröße in Bytes benötigt.
Anfragebeispiel
Antwortbeispiel
Wenn die Anfrage erfolgreich ist, wird eine Platzhalter-Dateiressource ohne Inhalt erstellt.Je nach Dateigröße enthält der Antwortfließtext eine oder mehrere upload_urls.Bei diesem Beispiel müssen wir diesen Upload in mehreren Teilen verwalten.
Wichtige Upload-Anforderungen:
Hier sind wichtige Details, die Sie bei nachfolgenden Upload-Anfragen beachten müssen:
- Die HTTP-Anfragemethode muss
PUTsein. - Der
x-amz-acl-Header muss enthalten sein und auf „privat“ eingestellt sein. - Der Header
Content-Typemuss mit demmedia_typeübereinstimmen, der in der ursprünglichen Anfrage Datei erstellen (lokal hochladen) angegeben wurde.Dies gilt auch beim Hochladen der Datei in separaten Teilen.Im obigen Beispiel lautet der Wert fürmedia_type``image/jpeg.Daher muss der Wert fürContent-Typeebenfallsimage/jpegsein.
Mehrteiliger Upload
Wenn eine bestimmte Datei zu mehr als einer Upload-URL führt, müssen Sie die Quelldatei in Chunks aufteilen und für jeden einzelnen eine PUT-Anfrage senden.
Empfehlung: Im Python SDK Upload-Leitfaden wird der mehrteilige Upload mit FrameioUploader dargelegt, mit dem das Chunking, parallele Uploads, Wiederholungsversuche und die Fortschrittsverfolgung vorkonfiguriert verarbeitet wird.
Wenn Sie den Upload manuell implementieren müssen – zum Beispiel in einer Sprache ohne SDK oder für vollständige Kontrolle über den Prozess –, sehen Sie im unten stehenden Skript, wie Sie eine Datei in Chunks aufteilen und jeden einzelnen mit den vorsignierten URLs hochladen.
Python-Implementierungsbeispiel
Zusammenfassung des Upload-Flusses
Wahl der Upload-Methode
Entscheiden Sie sich zwischen Remote-Upload (Datei über URL zugänglich) oder lokalem Upload (Datei auf Ihrem System).
Erstellen der Dateianfrage
Stellen Sie die erste Anfrage, um die Dateiressource mit den erforderlichen Metadaten zu erstellen.
Verarbeiten von Upload-URLs
Verarbeite bei lokalen Uploads die zurückgegebenen upload_urls (einzeln oder mehrere Teile)
Nächste Schritte: Sobald Ihre Datei hochgeladen ist, können Sie mit der zurückgegebenen Datei-ID Kommentare hinzufügen, Freigaben erstellen oder andere Vorgänge mit der Frame.io V4-API durchführen.