Fonctionnement des chargements locaux et distants
Ce guide décrit en détail la procédure complète pour charger des fichiers à l’aide de l’API Frame.io V4. Il couvre les requêtes et les réponses brutes de l’API pour les chargements locaux et à distance.
Vous recherchez des guides spécifiques au SDK ? Pour les implémentations de chargement intégrant le fractionnement en blocs, les tentatives et le suivi de la progression, consultez le Guide de chargement du SDK Python.
Conditions préalables
Avant de commencer à charger des fichiers, assurez-vous d’avoir suivi toutes les étapes de configuration suivantes :
Compte Frame.io V4
Vous disposez d’un compte Frame.io V4 géré via l’Adobe Admin Console OU vous êtes passé à l’authentification Adobe pour votre compte utilisateur.
Configuration de l’Adobe Developer Console
Vous vous êtes connecté à l’Adobe Developer Console et avez ajouté l’API Frame.io à un projet nouveau ou existant.
Informations d’authentification
Vous avez généré les informations d’authentification appropriées pour votre projet.
Choix de votre méthode de chargement
Il existe deux façons de charger un fichier à l’aide de l’API Frame.io : Créer un fichier (chargement local) et Créer un fichier (chargement à distance).
À utiliser lorsque le contenu est accessible localement depuis votre application, comme lorsque vous faites glisser un fichier depuis votre bureau.
À utiliser lorsque le contenu est accessible via le réseau, par exemple dans le cadre d’une intégration avec un autre service.
Dans ce guide, nous commencerons par le cas le plus simple : un chargement à distance.
Chargement à distance
Pour créer un fichier via un chargement à distance, sélectionnez le point d’entrée Créer un fichier (chargement à distance). Le corps de la requête doit contenir le nom du fichier et son URL source.
Il est actuellement possible de charger jusqu’à 50 Go via le chargement à distance. Pour les fichiers de plus de 50 Go, veuillez utiliser le chargement local.
Exemple de requête
Exemple de réponse
Une requête réussie donnera lieu à une réponse semblable à celle ci-dessous :
Chargement local
Pour créer un fichier via un chargement local, sélectionnez le point d’entrée Créer un fichier (chargement local). Le corps de la requête doit comporter le nom du fichier et sa taille en octets.
Exemple de requête
Exemple de réponse
Si la requête aboutit, un espace réservé de ressource de fichier est créé, sans aucun contenu. En fonction de la taille du fichier, le corps de la réponse comprendra une ou plusieurs upload_urls. Compte tenu de cet exemple, nous devrons gérer ce chargement en plusieurs parties.
Conditions importantes relatives au chargement :
Voici quelques points importants à garder à l’esprit lorsque vous envoyez la ou les requêtes de chargement suivantes :
- La méthode de requête HTTP doit être
PUT. - L’en-tête
x-amz-acldoit être inclus et défini sur « private ». - L’en-tête
Content-Typedoit correspondre aumedia_typespécifié dans la requête Créer un fichier (chargement local) originale. Cela vaut également lorsque vous chargez le fichier en plusieurs parties. Dans l’exemple ci-dessus, la valeur demedia_typeestimage/jpeg. Par conséquent, la valeur deContent-Typedoit également êtreimage/jpeg.
Chargement en plusieurs parties
Lorsqu’un fichier donné génère plusieurs URL de chargement, vous devez diviser le fichier source en plusieurs blocs et envoyer une requête PUT pour chacun d’entre eux.
Recommandation : le Guide de chargement du SDK Python traite du chargement en plusieurs parties à l’aide de FrameioUploader, qui gère d’emblée le fractionnement en blocs, les chargements parallèles, les nouvelles tentatives et le suivi de la progression.
Si vous devez effectuer le chargement manuellement (par exemple, dans une langue pour laquelle il n’existe pas de SDK ou pour bénéficier d’un contrôle total sur le processus), le script ci-dessous vous montre comment fractionner un fichier en blocs et charger chacun d’entre eux à l’aide d’URL pré-signées.
Exemple d’implémentation en Python
Résumé du flux de chargement
Choisir la méthode de chargement
Choisissez entre le chargement à distance (fichier accessible via une URL) ou le chargement local (fichier stocké sur votre système).
Créer une requête de fichier
Effectuez la requête initiale de création de la ressource de fichier avec les métadonnées requises.
Gérer les URL de chargement
Pour les chargements locaux, traitez les uploard_urls renvoyées (en une ou plusieurs parties).
Étapes suivantes : une fois votre fichier chargé, vous pouvez utiliser l’identifiant du fichier fourni pour ajouter des commentaires, créer des partages ou effectuer d’autres opérations à l’aide de l’API Frame.io V4.