API ReferenceDossiers

Répertorier les éléments enfants

Répertorier les éléments enfants dans le dossier spécifié. <br/> Le paramètre de requête `include` permet d’inclure de manière sélective des propriétés supplémentaires dans la réponse. <br/> Remarque : si vous incluez `media_links.original` et que l’utilisateur ne dispose pas de l’autorisation de téléchargement des fichiers dans le projet correspondant, ce point d’entrée renvoie une erreur `403 Forbidden`. Si le contenu est inaccessible parce que l’ajout d’un filigrane est requis pour cet utilisateur et n’est pas pris en charge par les media_links demandés, la requête aboutit, mais les liens média non pris en charge sont définis sur NULL. De même, si un lien de transcodage demandé n’existe pas pour un fichier particulier (par exemple, l’inclusion de `media_links.video_h264_180` sur un fichier image statique) ou si le processus de transcodage n’est pas terminé (c’est-à-dire que le `status` du fichier est "uploaded" plutôt que "transcoded"), un lien média est également défini sur NULL dans la payload de la réponse. En bref, le client doit gérer les liens média NULL correctement. <br/>Limites de débit : 100 appels par minute et par account_user

Authentification

AuthorizationBearer

Authentification bearer de la forme Bearer <token>, où token est votre jeton d’authentification.

Paramètres de chemin

account_idstringRequis
A Frame.io or Adobe entity identifier. Typically a Frame.io UUID. But for accounts, projects, folders, files, and version stacks that reside in Adobe cloud storage, which is the case for Workfront-connected accounts and projects, an Adobe-assigned id may also be used interchangeably. These ids must be prefixed with `adobe:` (e.g. `adobe:<adobe_org_id>` for an account, `adobe:<adobe_asset_id>` for a project or folder, `adobe:`adobe:<adobe_asset_id>|<version>` for a file asset).
folder_idstringRequis
A Frame.io or Adobe entity identifier. Typically a Frame.io UUID. But for accounts, projects, folders, files, and version stacks that reside in Adobe cloud storage, which is the case for Workfront-connected accounts and projects, an Adobe-assigned id may also be used interchangeably. These ids must be prefixed with `adobe:` (e.g. `adobe:<adobe_org_id>` for an account, `adobe:<adobe_asset_id>` for a project or folder, `adobe:`adobe:<adobe_asset_id>|<version>` for a file asset).

Paramètres de requête

includeenumOptionnel

Valeurs prises en charge du paramètre de requête include pour les points d’entrée qui renvoient des fichiers comportant des liens de médias

typestringOptionnel

Filtre de type pour les éléments enfants du dossier

afterstringOptionnel

Paramètre de requête de curseur opaque pour les requêtes renvoyant des résultats paginés.


REMARQUE : cette valeur est générée automatiquement et incluse dans les liens d’une réponse précédente. Elle n’est pas destinée à être lisible par un humain.

page_sizeintegerOptionnel1-100Par défaut 50

Paramètre de requête de taille de page pour les demandes

include_total_countbooleanOptionnelPar défaut false

Paramètre de requête de page permettant d’inclure le nombre total de toutes les entités

En-têtes de réponse

x-ratelimit-limitinteger

Limite de débit

x-ratelimit-remaininginteger

Limite de débit restante

x-ratelimit-windowinteger

Fenêtre de limite de débit en millisecondes

Réponse

OK
datalist of objects
Ressources
total_countinteger or null
Nombre total

Erreurs

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error