API ReferenceFichiers

Afficher le fichier

Afficher les détails d’un fichier. <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écharger le fichier, 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, en incluant `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 statut (`status`) du fichier est "uploaded" plutôt que "transcoded"), le lien 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 : 10 appels par seconde 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).
file_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

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
dataobject

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