Synupv1
Créer une clé
v1Ressources/Media/patchMettre à jour un asset

Mettre à jour un asset

Met à jour les métadonnées de recouvrement d'un asset — étiquettes, appartenance à un dossier, établissements assignés — et, pour les téléversements uniquement, son titre. Les sources synchronisées/générées ignorent le titre ; il y est en lecture seule.

patch/api/v1/media/{id}
media:write
Paramètres de requête
idstringobligatoire
L'asset à mettre à jour.
Corps de la requête
titlestringfacultatif
Nouveau titre. Téléversements uniquement ; ignoré pour les autres sources.
tagsarray of stringfacultatif
Remplace la liste complète des étiquettes de l'asset, par nom.
folderIdsarray of stringfacultatif
Remplace l'appartenance aux dossiers de l'asset.
locationIdsarray of stringfacultatif
Remplace les établissements assignés de l'asset.
statusstring (ok | needs_review | spam)facultatif
Définit manuellement le verdict de modération. Médias synchronisés uniquement.
statusReasonstringfacultatif
Note facultative expliquant le statut, affichée à côté de celui-ci.
Réponse
dataobjectfacultatif
assetobjectfacultatif
keystringfacultatif
Identifiant composite du fichier, au format « <source>:<id> ».
sourcestringfacultatif
Origine de ce fichier (par ex. un envoi OS par rapport à une source importée).
idstringfacultatif
L'id du fichier au sein de sa source.
titlestringfacultatif
Le titre du fichier.
filenamestringfacultatif
Le nom de fichier d'origine du fichier.
mimestringfacultatif
Le type MIME du fichier.
kindstringfacultatif
Le type du fichier (photo ou vidéo).
sizeBytesnumberfacultatif
Taille du fichier en octets, ou null si inconnue.
urlstringfacultatif
URL prête à l'emploi pour les octets du fichier.
thumbnailUrlstringfacultatif
URL d'un aperçu miniature, ou null.
tagsarray of stringfacultatif
Étiquettes associées au fichier.
folderIdsarray of stringfacultatif
Dossiers de fichiers auxquels ce fichier appartient.
locationIdsarray of stringfacultatif
Tous les établissements auxquels ce fichier est associé.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
patch/api/v1/media/{id}
Votre clé API
id *
Corps de la requête
{
  "data": {
    "asset": {
      "key": "upload:abc123",
      "source": "upload",
      "id": "abc123",
      "title": "Storefront photo",
      "filename": "storefront.jpg",
      "mime": "image/jpeg",
      "kind": "image",
      "sizeBytes": 482913,
      "url": "https://cdn.synup.com/media/abc123.jpg",
      "thumbnailUrl": "https://cdn.synup.com/media/abc123-thumb.jpg",
      "tags": [
        "VIP"
      ],
      "folderIds": [
        "folder_1"
      ],
      "locationIds": [
        "loc_456"
      ]
    }
  }
}