Referencia de mensajes de error de la API de CMS

Esta es una referencia a los mensajes de error devueltos por la API de CMS. Ver también la referencia del mensaje de error para la API de ingesta dinámica , que se utiliza junto con el CMS API para ingesta de videos.

Mensajes de error generales

Estado Nombre Mensaje Causa
400 BAD_REQUEST ILLEGAL_PATH: A request for more than 10 videos is not supported Lo básico GET /videos/video_ids la solicitud no puede solicitar más de 10 videos
400 INVALID_SORT Attempted to sort by invalid property: '[property name]' La sort param apuntó a un campo inválido o inexistente
400 INVALID_SEARCH Search string was invalid La sintaxis de la cadena de búsqueda no es válida o no se pudo codificar mediante URIEncode la cadena de búsqueda
400 ILLEGAL_QUERY There was a problem with the query string La sintaxis de la cadena de búsqueda no es válida; ejemplo: 1) haciendo un tags búsqueda que termina con una coma o tiene una comilla sin cerrar
400 BAD_VALUE Unrecognized field in the submitted data Error de ortografía u otro uso de un campo inexistente
400 AD_CONFIG_NOT_FOUND Ad config not found No se encontró la configuración de anuncios especificada en una solicitud SSAI
400 AD_CONFIG_INACTIVE Ad config is inactive La configuración de anuncios especificada en una solicitud SSAI está inactiva
400 REFERENCES_EXIST This video is referenced by at least one playlist. Está intentando eliminar un video que está incluido en al menos una lista de reproducción.
400 SHARED_VIDEO Delete of shared video failed. Aún no se admite la eliminación de videos compartidos.
401 UNAUTHORIZED Permission denied. Token de acceso de OAuth faltante o no válido. Si proporcionó un token de acceso, es posible que no tenga el alcance adecuado para esta solicitud
403 NOT_AVAILABLE Resource is not available. El recurso que está solicitando no está disponible temporalmente; esto puede ser una condición temporal mientras se está procesando algún tipo de video, pero si el mensaje persiste, comuníquese con el Soporte.
404 RESOURCE_NOT_FOUND Resource does not exist. Ha solicitado un recurso que no existe: compruebe la ortografía de los elementos de la ruta.
405 METHOD_NOT_ALLOWED The HTTP method used for the request is not allowed for this resource La causa más común es enviar un PUT, POST, PATCH o DELETE a un recurso de solo lectura.
406 NOT_ACCEPTABLE The HTTP Accept header has a value not allowed. El Accept el encabezado debe tener el valor application/json ; otros valores como application/x-www-form-urlencoded hará que la solicitud sea rechazada con este error.
409 LIVE_VIDEOS_NOT_SHAREABLE This video cannot be shared because it is live. Los videos de transmisión en vivo y los clips creados a partir de ellos no se pueden compartir.
409 REFERENCE_ID_IN_USE Reference id is already in use. Intentó crear un video con una identificación de referencia que ya está en uso, o agregar una identificación de referencia a un video que ya está siendo usado por otro video.
409 CONCURRENT_UPDATE Update failed because of another update at the same time. Please try again. Una solicitud de API separada, un usuario de Studio o algún proceso del sistema está actualizando el video. Esto también puede ocurrir si realiza solicitudes de actualización de API en el mismo video de forma asincrónica, en rápida sucesión.
409 CONFLICT Reference id is already in use. Para asegurar la unicidad de los identificadores de referencia, las operaciones que involucran identificadores de referencia bloquearán el identificador hasta por 3 minutos. Eso significa que si realiza una solicitud que crea o cambia una identificación de referencia y luego realiza cualquier otra solicitud que use esa identificación de referencia inmediatamente, la operación fallará con un error 409. Esto incluiría: 1) eliminar un video y luego intentar asignar su identificación de referencia a otro video; 2) intentar crear un nuevo video que falla con un error 503 (servicio no disponible) y volver a intentar la misma solicitud.

Espere al menos 3 minutos después de recibir este error antes de volver a intentar la operación. Tenga en cuenta también que si intenta crear un video con una identificación de referencia y el intento falla (por razones no relacionadas con la identificación de referencia), esa identificación de referencia se bloqueará durante 30 segundos y los intentos repetidos de crear el video fallarán hasta que usted espere el tiempo suficiente para que se desbloquee la identificación de referencia.
409 CONFLICT Both accounts must be enabled for media sharing. Cuando una cuenta maestra intenta agregar una cuenta de afiliado a un canal para compartir medios, ambas cosas las cuentas deben estar habilitadas para compartir medios.
409 UNSUPPORTED_MEDIA_TYPE   Lo más probable es que a la solicitud le falte el encabezado: Content-Type: application/json.
415 SHARING_DISABLED Master account is not enabled for media sharing. Este error se devolverá si intenta compartir un video desde una cuenta que no tiene habilitado el uso compartido de medios.
422 ILLEGAL_FIELD Unrecognized field in the submitted data Error de ortografía u otro uso de un campo inexistente
422 VALIDATION_ERROR (los datos JSON no eran válidos; los mensajes de error varían según el problema) Ejemplos de mensajes:
  • nombre: REQUIRED_FIELD (crea un video sin un nombre, actualiza el nombre a una cadena vacía)
  • ID de la cuenta: CUENTA EQUIVOCADA  (el ID de la cuenta en la URL no coincide con el ID de la cuenta en JSON)
  • Claves no válidas: id (la identificación no se puede modificar y no debe aparecer como clave en el JSON)
429 TOO_MANY_REQUESTS Too many requests Está enviando demasiadas solicitudes simultáneas o demasiadas solicitudes por segundo
500 UNKNOWN an unknown internal error occurred Problema en el sistema Brightcove; inténtelo de nuevo más tarde.
503 SERVICE_UNAVAILABLE The API is temporarily unavailable Problema de backend: inténtalo de nuevo más tarde.
504 TIMEOUT something took too long Es probable que el servidor esté demasiado ocupado; inténtelo de nuevo más tarde.

Errores de uso compartido de medios

Los errores de uso compartido de medios no se devuelven como una respuesta de error separada a la solicitud de la API, sino en una error_message campo en la respuesta normal:

  [
  {
  "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]"}]"
  }
  ]

La error_message json será una matriz de objetos de error, el objeto tendrá error_code y error_message.

error_code

El código de error generalmente será específico para compartir, pero podría ser cualquiera de los códigos de error válidos que también se pueden devolver mediante una operación de PATCH (actualización) en un video. Los códigos de error específicos para compartir se muestran en la siguiente tabla.

Códigos de error de uso compartido de medios
error_code error_message Causa
MISSING_CUSTOM_FIELDS Affiliate account is missing custom fields: [field1, field2] El maestro ha puesto enforce_custom_fields a true , pero el video que se comparte hace referencia a campos que no existen en la cuenta de afiliado.
CONFLICT Affiliate account is not configured for geo restriction. El maestro tiene enforce_geo establecido en verdadero y su cuenta está configurada para el filtrado geográfico, pero la cuenta de afiliado no está configurada para el filtrado geográfico.
SHARING_DISABLED Affiliate account is not enabled for media sharing. El maestro ha intentado compartir un video con un afiliado que no está habilitado para compartir contenido multimedia.
NOT_FOUND Resource does not exist. Algo faltaba. Por lo general, esto significa que el video maestro se ha ido. Esto puede suceder si una solicitud para compartir es seguida inmediatamente por una eliminación del video maestro. Esto también podría significar que la cuenta maestra aún no tiene un canal o si la cuenta de afiliado no existe o no es un miembro válido del canal. Esto podría suceder si algo salió mal durante la migración a CMS API uso compartido de medios.
UNKNOWN Sharing failed with an unknown error, error_id INSERT-UNIQUE-ERROR-ID Ocurrió algo inesperado. El error_message incluirá un ID de error que devops puede utilizar para identificar la causa subyacente. Reintentar el intento de compartir funcionará en muchos casos.
VALIDATION_ERROR {field}: ILLEGAL_VALUE Si {field} es "economía", entonces el problema es que el video principal es "ADMINISTRADO POR ANUNCIOS" pero la cuenta de afiliado no tiene anuncios habilitados. También ocurre si configura la Publicidad como Admite anuncios en los metadatos del video (de un video no compartido) cuando la cuenta está deshabilitada para anuncios. Si {campo} es otra cosa, entonces se requiere investigación.
REFERENCE_ID_IN_USE Reference id whatever-you-used is already in use. La identificación de referencia era válida en la cuenta maestra, pero la cuenta de afiliado ya la usa.