Détail d'un média (JSON) : toute la fiche d'un fichier, prête à l'emploi en un seul appel
Détail d'un média (JSON) une fonctionnalité du module Médiathèque de Clustraly. Le détail d'un média (JSON) renvoie, en un seul appel, la fiche complète d'un fichier enrichie d'URL publique, de taille lisible, de drapeaux de type et de son usage.
Vous consultez un fichier et vous recevez tout d'un coup : ses métadonnées, son URL, sa taille lisible, ses drapeaux de type et le repérage de ses usages. Une réponse enrichie côté serveur, prévisible, prête à afficher ou à intégrer.
Le détail d'un média (JSON) vous donne toute la fiche en un appel
Vous demandez la fiche d'un fichier et vous recevez tout d'un coup : ses métadonnées, son URL publique et sa taille déjà lisible. Pas de second aller-retour pour compléter l'affichage.
Derrière, GET /admin/media/{id} renvoie un JSON complet du média, déjà enrichi de champs calculés côté serveur.
- URL publique prête à afficher (getUrl)
- Taille déjà formatée en lisible (getHumanSize)
- Catégorie de type, icône et couleur d'icône
Des informations enrichies que vous n'avez plus à recalculer
Vous décidez comment présenter le média ; la fiche vous livre déjà les éléments prêts à l'emploi : l'URL publique, la taille lisible, l'icône et sa couleur, la catégorie de type.
Les drapeaux is_image, is_video, is_audio et is_pdf vous disent d'un coup d'œil à quel genre de fichier vous avez affaire, sans avoir à deviner à partir du MIME.
- Drapeaux is_image, is_video, is_audio, is_pdf
- Catégorie de type pour router l'affichage
- Icône et couleur cohérentes avec la grille
Voyez où le fichier est utilisé, directement dans la fiche
Avant de remplacer ou de retirer un média, vous voulez savoir qui s'en sert. Le scan d'utilisation est inclus dans le champ usage de la fiche, sans requête supplémentaire.
findUsage repère les articles et pages qui référencent le fichier et vous les remonte dans data['usage'].
- Champ usage livré avec le détail
- Références repérées avant d'agir
- Vous décidez en connaissance de cause
Une même fiche pour prévisualiser, inspecter et intégrer
Vous alimentez un panneau d'inspection dans l'admin, une prévisualisation avant insertion ou une intégration : la même réponse JSON couvre ces besoins.
Comme chaque champ est déjà calculé et présent, vous branchez l'affichage sans logique supplémentaire côté client.
- Prévisualiser un média avant de l'insérer
- Construire un panneau de détail admin
- Alimenter une intégration à partir d'un JSON stable
Des réponses prévisibles, y compris quand ça se passe mal
Vous intégrez sans mauvaise surprise : title, description, caption et alt_text sont normalisés à une chaîne vide quand ils manquent, jamais laissés à null.
Un média introuvable renvoie 404 ; une erreur serveur renvoie 500 et reste journalisée via error_log pour le diagnostic.
- Champs texte normalisés, jamais null
- 404 clair si le média est introuvable
- 500 journalisé via error_log en cas d'erreur
Vous consultez, rien n'est modifié
Le détail d'un média est en lecture seule : il renvoie la fiche du fichier sans y toucher. Vous inspectez, vous comparez, puis vous décidez de l'action à mener depuis les autres outils de la Médiathèque.
Questions fréquentes
Que contient le JSON du détail d'un média ?
Le détail indique-t-il où le fichier est utilisé ?
Que se passe-t-il si le média n'existe pas ?
Comment sont gérés les champs de métadonnées vides ?
Fonctionnalités liées
Grille de la médiathèque (navigation, filtre par type, recherche, pagination)
Parcourir • Filtrer • Rechercher • Paginer
DécouvrirNavigateur AJAX pour l'éditeur riche (TinyMCE)
Parcourir • Sélectionner • Paginer
DécouvrirTéléversement sécurisé 7 couches de validation
Téléverser • Valider • Bloquer • Randomiser le nom
DécouvrirUne fiche média complète, prête à consulter et à intégrer
Le détail d'un média (JSON) rassemble en une seule réponse enrichie et prévisible tout ce que vous devez savoir sur un fichier : ses métadonnées, son URL, sa taille lisible, ses drapeaux de type et ses usages. L'IA vous apporte le contexte ; vous gardez la décision.