Paper Contacter le support | état du système L'état du système
Contenu de la page

    CMS API Référence du message d'erreur

    Il s’agit d’une référence aux messages d’erreur renvoyés par le CMS API. Regarde aussi la référence du message d'erreur pour le Dynamic Ingest API, qui est utilisé conjointement avec CMS API pour ingérer des vidéos.

    Messages d'erreur généraux

    Statut Nom Message Causes
    400 BAD_REQUEST ILLEGAL_PATH: A request for more than 10 videos is not supported Les bases GET /videos/video_ids demande ne peut pas demander plus de vidéos 10
    400 INVALID_SORT Attempted to sort by invalid property: '[property name]' Le système sort param pointé vers un champ invalide ou inexistant
    400 INVALID_SEARCH Search string was invalid La syntaxe de la chaîne de recherche n'était pas valide ou vous n'avez pas réussi à URIEncode la chaîne de recherche
    400 ILLEGAL_QUERY There was a problem with the query string La syntaxe de la chaîne de recherche était invalide - exemple: 1) faisant un tags recherche qui se termine par une virgule ou a un devis non fermé
    400 BAD_VALUE Unrecognized field in the submitted data Erreur d'orthographe ou autre utilisation de champ inexistant
    400 AD_CONFIG_NOT_FOUND Ad config not found La configuration d'annonce spécifiée dans une requête SSAI n'a pas été trouvée
    400 AD_CONFIG_INACTIVE Ad config is inactive La configuration de l'annonce spécifiée dans une requête SSAI est inactive
    400 REFERENCES_EXIST This video is referenced by at least one playlist. Vous essayez de supprimer une vidéo incluse dans au moins une playlist.
    400 SHARED_VIDEO Delete of shared video failed. La suppression de vidéos partagées n'est pas encore prise en charge.
    401 UNAUTHORIZED Permission denied. Jeton d'accès OAuth manquant ou non valide. Si vous avez fourni un jeton d'accès, il se peut qu'il n'ait pas la portée appropriée pour cette demande.
    403 NOT_AVAILABLE Resource is not available. La ressource que vous demandez est temporairement indisponible - il s'agit peut-être d'une condition temporaire lorsqu'un traitement de la vidéo est en cours, mais si le message persiste, contactez le support technique.
    404 NOT_FOUND Resource does not exist. Vous avez demandé une ressource qui n'existe pas - vérifiez l'orthographe.
    405 METHOD_NOT_ALLOWED The HTTP method used for the request is not allowed for this resource La cause la plus courante est l'envoi d'un PUT, POST, PATCH ou DELETE à une ressource en lecture seule.
    406 NOT_ACCEPTABLE The HTTP Accept header has a value not allowed. Le système Accept l'en-tête doit avoir la valeur application/json; d'autres valeurs telles que application/x-www-form-urlencoded entraînera le rejet de la demande avec cette erreur.
    409 LIVE_VIDEOS_NOT_SHAREABLE This video cannot be shared because it is live. Live les vidéos en streaming et les clips créés à partir de ceux-ci ne peuvent pas être partagés.
    409 REFERENCE_ID_IN_USE Reference id is already in use. Vous avez tenté de créer une vidéo avec un ID de référence déjà utilisé ou d'ajouter un ID de référence à une vidéo déjà utilisée par une autre vidéo.
    409 CONCURRENT_UPDATE Update failed because of another update at the same time. Please try again. Une demande d'API distincte, un utilisateur de Studio ou un processus système met actuellement à jour la vidéo. Cela peut également se produire si vous effectuez des demandes de mise à jour d'API sur la même vidéo de manière asynchrone, en succession rapide.
    409 CONFLICT Reference id is already in use. Pour garantir l'unicité des identifiants de référence, les opérations impliquant des identifiants de référence verrouillent l'identifiant pendant un maximum de minutes 3. Cela signifie que si vous faites une demande qui crée ou modifie un identifiant de référence, puis effectuez immédiatement toute autre demande utilisant cet identifiant de référence, l'opération échouera avec une erreur 409. Cela inclut: 1) la suppression d’une vidéo et l’essai d’attribuer son identifiant de référence à une autre vidéo; 2) tente de créer une nouvelle vidéo qui échoue avec une erreur 503 (service indisponible) et réessaie la même demande.

    Veuillez patienter au moins 3 minutes après avoir obtenu cette erreur avant de réessayer l'opération. Notez également que si vous essayez de créer une vidéo avec un identifiant de référence et que cette tentative échoue (pour des raisons indépendantes de l'ID de référence), cet identifiant de référence sera verrouillé pendant des secondes 30 et les tentatives répétées de création de la vidéo échoueront jusqu'à ce que vous attendez assez longtemps pour que l'ID de référence soit déverrouillé.
    409 CONFLICT Both accounts must be enabled for media sharing. Lorsqu'un compte principal tente d'ajouter un compte affilié à un canal pour le partage de médias, tous les deux les comptes doivent être activés pour le partage de médias.
    409 UNSUPPORTED_MEDIA_TYPE La demande manque probablement l'en-tête: Content-Type: application/json.
    415 SHARING_DISABLED Master account is not enabled for media sharing. Cette erreur sera renvoyée si vous tentez de partager une vidéo à partir d'un compte sur lequel le partage de médias n'est pas activé.
    422 ILLEGAL_FIELD Unrecognized field in the submitted data Erreur d'orthographe ou autre utilisation de champ inexistant
    422 VALIDATION_ERROR (les données JSON n'étaient pas valides - les messages d'erreur varient en fonction du problème) Exemples de messages:
    • name: REQUIRED_FIELD (créer une vidéo avec un nom, mettre à jour le nom de la chaîne vide)
    • account_id: WRONG_ACCOUNT (l'identifiant de compte dans l'URL ne correspond pas à l'identifiant du compte dans JSON)
    • Clés invalides: id (l'identifiant ne peut pas être modifié et ne devrait pas apparaître comme clé dans le JSON)
    429 TOO_MANY_REQUESTS Too many requests Vous soumettez trop de requêtes simultanées ou trop de requêtes par seconde
    500 UNKNOWN an unknown internal error occurred Problème dans le système Brightcove - réessayez plus tard.
    503 SERVICE_UNAVAILABLE The API is temporarily unavailable Problème backend - réessayez plus tard.
    504 TIMEOUT something took too long Le serveur est probablement trop occupé - réessayez plus tard.

    Erreurs de partage de médias

    Les erreurs de partage de média ne sont pas renvoyées en tant que réponse d'erreur distincte à la demande d'API, mais plutôt dans une error_message champ dans la réponse normale:

      [
  {
  "video_id" : "394872349182374",
  "affiliate_id" : "234987239487",
  "affiliate_video_id" : "30308254055202",
  "status" : "COMPLETE",
  "shared_at" : "2017-12-11T17:57:45.530Z",
  "updated_at" : "2017-12-11T18:03:32.789Z",
  "error_message" : "[{"error_code":"MISSING_CUSTOM_FIELDS","error_message":"Affiliate account is missing custom fields: [whisky]"}]"
  }
  ]

    Le système error_message json sera un tableau d'objets d'erreur, l'objet aura error_code et error_message.

    error_code

    Le code d'erreur est généralement spécifique au partage, mais il peut s'agir de l'un des codes d'erreur valides pouvant être renvoyés par une opération PATCH (mise à jour) sur une vidéo. Les codes d'erreur spécifiques au partage sont indiqués dans le tableau ci-dessous.

    Codes d'erreur de partage de médias
    error_code error_message Causes
    MISSING_CUSTOM_FIELDS Affiliate account is missing custom fields: [field1, field2]} Le maître a mis enforce_custom_fields à true, mais la vidéo en cours de partage fait référence à des champs qui n'existent pas dans le compte affilié.
    CONFLICT Affiliate account is not configured for geo restriction. Enforce_geo a la valeur true pour le maître et son compte est configuré pour le géofiltrage, mais le compte affilié n'est pas configuré pour le géofiltrage.
    SHARING_DISABLED Affiliate account is not enabled for media sharing. Le maître a tenté de partager une vidéo avec un affilié qui n'est pas activé pour le partage multimédia.
    NOT_FOUND Resource does not exist. Quelque chose manquait. Cela signifie généralement que la vidéo principale a disparu. Cela peut se produire si une demande de partage est immédiatement suivie d'une suppression de la vidéo principale. Cela peut également signifier que le compte principal n'a pas encore de canal ou si le compte affilié n'existe pas ou n'est pas un membre valide du canal. Cela pourrait arriver si quelque chose n'allait pas dans la migration vers CMS API Partage médiatique.
    UNKNOWN Sharing failed with an unknown error, error_id INSERT-UNIQUE-ERROR-ID Quelque chose d'inattendu est arrivé. Le message error_message inclura un identifiant d'erreur pouvant être utilisé par les développeurs pour identifier la cause sous-jacente. Réessayer la tentative de partage fonctionnera dans de nombreux cas.
    VALIDATION_ERROR {field}: ILLEGAL_VALUE Si {field} correspond à "economics", le problème est que la vidéo principale est "AD SUPPORTED" mais que les annonces ne sont pas activées pour le compte affilié. Cela se produit également si vous définissez la publicité à l'annonce prise en charge sur les métadonnées vidéo (d'une vidéo non partagée) lorsque le compte est désactivé pour les annonces. Si {field} est autre chose, une investigation est requise.
    REFERENCE_ID_IN_USE Reference id whatever-you-used is already in use. L'identifiant de référence était valide dans le compte principal mais est déjà utilisé par le compte affilié.
    Dernière mise à jour de la page le 12 juin 2020