soporte Contactar con asistencia técnica | estado del sistema Estado del Sistema
Contenido de la página

    Notificaciones para ingesta dinámica

    En este tema, obtendrá información sobre las notificaciones para los trabajos de ingesta de Dynamic Delivery enviados mediante el Dynamic Ingest API.

    Dynamic Ingest API notificaciones

    Puede especificar una o más URL de devolución de llamada para recibir notificaciones de los resultados del proceso de ingesta. Las URL que especifique deben ser para aplicaciones que puedan aceptar solicitudes POST. Las notificaciones se enviarán en formato JSON.

    Preparar

    He aquí un ejemplo.

    • Usuario con pub ID 57838016001
    • Quiere usar Dynamic Ingest para cargar un archivo de video fuente ubicado en https://s3.amazonaws.com/bucket/mysourcevideo.mp4
    • Quiere cargar un título existente en el catálogo con la identificación de video 5199670523001
    • Usar el perfil estático multiplataforma estándar
    • Desea recibir devoluciones de llamada en dos puntos finales ubicados en http: // host1 / path1 y http: // host2 / path2 respectivamente

    La solicitud DI se vería así:

    Solicitud POST

    Solicitar cuerpo

        {
          "master": {
            "url": "https://s3.amazonaws.com/bucket/mysourcevideo.mp4"
          },
          "profile": "multi-platform-standard-static",
          "callbacks": ["http://host1/path1”, “http://host2/path2”]
        }

    Notificación de muestra

    Las notificaciones se envían como solicitudes POST con la notificación en el cuerpo de la solicitud como JSON. [] . Aquí hay un conjunto completo de notificaciones de un trabajo de ingesta de video típico:

    {
          "entity": "default\/audio192",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/audio192",
          "language": "en",
          "variant": "main",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/audio64",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/audio64",
          "language": "en",
          "variant": "main",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/audio96",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/audio96",
          "language": "en",
          "variant": "main",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/audio128",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/audio128",
          "language": "en",
          "variant": "main",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "5660367449001",
          "entityType": "DIGITAL_MASTER",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video450",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video450",
          "bitrate": 451,
          "width": 480,
          "height": 270,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "5660367449001",
          "entityType": "TITLE",
          "version": "1",
          "action": "PUBLISH",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "thumbnail",
          "entityType": "ASSET",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "poster",
          "entityType": "ASSET",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video900",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video900",
          "bitrate": 901,
          "width": 640,
          "height": 360,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video700",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video700",
          "bitrate": 700,
          "width": 640,
          "height": 360,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video1200",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video1200",
          "bitrate": 1204,
          "width": 960,
          "height": 540,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video1700",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video1700",
          "bitrate": 1703,
          "width": 960,
          "height": 540,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video3500",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video3500",
          "bitrate": 3498,
          "width": 1920,
          "height": 1080,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video2000",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video2000",
          "bitrate": 2000,
          "width": 1280,
          "height": 720,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video3800",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video3800",
          "bitrate": 3804,
          "width": 1920,
          "height": 1080,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "5660367449001",
          "entityType": "TITLE",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }

    Campos de notificación

    Asunto Descripción
    status se mostrarán FAILED si la captura o creación de una entrega no fue exitosa, SUCCESS si la solicitud tuvo éxito
    accountId la identificación de la cuenta
    videoId el video id
    jobId la identificación del trabajo para la solicitud de ingesta dinámica
    entity ya sea el nombre de la entidad, o el Video Cloud ID del video para el título
    entityType el tipo de activo reportado, por ejemplo: TITLE (un video), DIGITAL_MASTER, ASSET (una reproducción, archivo de subtítulos o imagen)
    bitrate bitrate para una interpretación
    width ancho de fotograma para una interpretación
    height altura de fotograma para una interpretación
    errorMessage una explicación de por qué la ingesta falló si lo hizo
    version una cadena siempre igual a "1"
    action la acción que ocurrió, por ejemplo, CREAR

    Interpretando notificaciones

    Una notificación que contiene "action": "CREATE" y "status": "SUCCESS" indica la finalización de un proceso.

    • Si la línea entityType is TITLE, luego se completa el procesamiento de un video ingerido.
    • Para las entityType: TITLE, action: PUBLISH se refiere a la hora en que se activó el video. Para videos que están inmediatamente activos, esto será aproximadamente el mismo tiempo que el CREATE hora.
    • Si la línea entityType is ASSET, DYNAMIC_RENDITION or DIGITAL_MASTER, luego se ha agregado exitosamente una reproducción, imagen, manifiesto, archivo WebVTT o maestro digital a su video.

    Página actualizada por última vez el 12 jun 2020