Référence des messages d'erreur de l'API CMS

Ceci est une référence aux messages d'erreur renvoyés par l'API CMS. Voir également la référence du message d'erreur pour l'API Dynamic Ingest, qui est utilisée conjointement avec le CMS API pour ingérer des vidéos.

Messages d'erreur généraux

Statut Prénom Message Causer
400 BAD_REQUEST ILLEGAL_PATH: A request for more than 10 videos is not supported Les bases GET /videos/video_ids la demande ne peut pas demander plus de 10 vidéos
400 INVALID_SORT Attempted to sort by invalid property: '[property name]' Les sort param pointe 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 à encoder la chaîne de recherche en URIE
400 ILLEGAL_QUERY There was a problem with the query string La syntaxe de la chaîne de recherche n'était pas valide - exemple : 1) faire un tags recherche qui se termine par une virgule ou a une citation non fermée
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 demande SSAI est introuvable
400 AD_CONFIG_INACTIVE Ad config is inactive La configuration des annonces spécifiée dans une demande 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 liste de lecture.
400 SHARED_VIDEO Delete of shared video failed. La suppression des 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 peut s'agir d'une condition temporaire pendant que le traitement de la vidéo est en cours, mais si le message persiste, contactez le support technique.
404 RESOURCE_NOT_FOUND Resource does not exist. Vous avez demandé une ressource qui n'existe pas - vérifiez l'orthographe des éléments du chemin d'accès.
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. Les 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. Les vidéos diffusées en direct et les clips créés à partir de celles-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 identifiant de référence déjà utilisé ou d'ajouter un identifiant 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 3 minutes maximum. Cela signifie que si vous effectuez 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 comprendrait : 1) supprimer une vidéo puis essayer d'attribuer son identifiant de référence à une autre vidéo ; 2) essayer de créer une nouvelle vidéo qui échoue avec une erreur 503 (service non disponible) et réessayer la même demande.

Veuillez attendre 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 la tentative échoue (pour des raisons indépendantes de l'identifiant de référence), cet identifiant de référence sera verrouillé pendant 30 secondes 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'identifiant 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 d'affilié à un canal pour le partage de médias, les deux comptes doivent être activés pour le partage multimédia.
409 UNSUPPORTED_MEDIA_TYPE   Il manque probablement l'en-tête à la requê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 multimédia 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 sans nom, mettre à jour le nom en chaîne vide)
  • identifiant de compte: WRONG_ACCOUNT  (l'ID de compte dans l'URL ne correspond pas à l'ID de compte dans JSON)
  • Clés invalides : identifiant (l'identifiant ne peut pas être modifié et ne doit pas apparaître comme clé dans le JSON)
429 TOO_MANY_REQUESTS Too many requests Vous soumettez trop de demandes simultanées ou trop de demandes 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 de backend - réessayez plus tard.
504 TIMEOUT something took too long Serveur probablement trop occupé - réessayez plus tard.

Erreurs de partage de médias

Les erreurs de partage de médias ne sont pas renvoyées en tant que réponse d'erreur distincte à la demande d'API, mais plutôt dans un 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]"}]"
  }
  ]

Les error_message json sera un tableau d'objets d'erreur, l'objet aura error_code et error_message.

error_code

Le code d'erreur sera généralement spécifique au partage, mais il peut également 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édia
error_code error_message Causer
MISSING_CUSTOM_FIELDS Affiliate account is missing custom fields: [field1, field2] Le maître a mis enforce_custom_fields à true , mais la vidéo partagée fait référence à des champs qui n'existent pas dans le compte affilié.
CONFLICT Affiliate account is not configured for geo restriction. Le maître a "force_geo" défini sur true et son compte est configuré pour le filtrage géographique, mais le compte affilié n'est pas configuré pour le filtrage géographique.
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. Il manquait quelque chose. 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 chaîne ou si le compte affilié n'existe pas ou n'est pas un membre valide de la chaîne. Cela peut se produire si quelque chose se passait mal lors de la migration vers le partage de CMS API médias.
UNKNOWN Sharing failed with an unknown error, error_id INSERT-UNIQUE-ERROR-ID Quelque chose d'inattendu s'est produit. Le error_message inclura un identifiant d'erreur qui peut être utilisé par devops pour identifier la cause sous-jacente. Réessayer la tentative de partage fonctionnera dans de nombreux cas.
VALIDATION_ERROR {field}: ILLEGAL_VALUE Si {field} est « économique » alors le problème est que la vidéo principale est « AD SUPPORTED » mais que les annonces ne sont pas activées sur le compte d'affilié. Se produit également si vous définissez la publicité sur Publicité 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 publicités. Si {field} est autre chose, alors une enquête 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é.