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

    Notifications pour Dynamic Ingest

    Dans cette rubrique, vous en apprendrez plus sur les notifications des travaux d'acquisition Dynamic Delivery soumis à l'aide du Dynamic Ingest API.

    Dynamic Ingest API notifications

    Vous pouvez spécifier une ou plusieurs URL de rappel pour recevoir des notifications pour les résultats du processus d'ingestion. Les URL que vous spécifiez doivent être destinées aux applications pouvant accepter les demandes POST. Les notifications seront envoyées au format JSON.

    installation

    Voici un exemple.

    • Utilisateur avec l'id de pub 57838016001
    • Souhaite utiliser Dynamic Ingest pour télécharger un fichier vidéo source situé à l'adresse https://s3.amazonaws.com/bucket/mysourcevideo.mp4
    • Souhaite télécharger un titre existant dans le catalogue avec l'identifiant vidéo 5199670523001
    • Utilisation du profil multi-plateforme-standard-statique
    • Souhaite recevoir des rappels à deux extrémités situées respectivement à l'adresse http: // host1 / path1 et http: // host2 / path2

    La requête DI ressemblerait à ceci:

    Demande POST

    Demander un corps

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

    Exemple de notification

    Les notifications sont envoyées en tant que requêtes POST avec la notification dans le corps de la demande en tant que JSON. . Voici un ensemble complet de notifications provenant d'un travail d'intégration vidéo typique:

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

    Champs de notification

    Article Description
    status sera FAILED si l'acquisition ou la création d'une interprétation n'a pas réussi, SUCCESS si la requête a réussi
    accountId l'identifiant du compte
    videoId l'identifiant de la vidéo
    jobId l'ID du travail pour la requête Dynamic Ingest
    entity soit le nom de l'entité, soit le nom de Video Cloud id de la vidéo pour le TITRE
    entityType le type d'actif signalé - par exemple: TITLE (une vidéo), DIGITAL_MASTER, ASSET (un rendu, un fichier de légendes ou une image)
    bitrate bitrate pour une interprétation
    width frame-width pour une interprétation
    height frame-height pour une interprétation
    errorMessage une explication de la raison pour laquelle l'ingestion a échoué si elle l'a fait
    version une chaîne toujours égale à "1"
    action l'action qui s'est produite - par exemple, CREATE

    Interprétation des notifications

    Une notification contenant "action": "CREATE" et "status": "SUCCESS" indique l'achèvement d'un processus.

    • Si la entityType is TITLE, le traitement d'une vidéo ingérée est terminé.
    • Pour le entityType: TITLE, action: PUBLISH fait référence à l'heure à laquelle la vidéo est activée. Pour les vidéos immédiatement actives, ce sera à peu près au même moment que le CREATE le temps.
    • Si la entityType is ASSET, DYNAMIC_RENDITION or DIGITAL_MASTER, puis un rendu, une image, un manifeste, un fichier WebVTT ou un fichier master numérique a été ajouté à votre vidéo.
    Dernière mise à jour de la page le 12 juin 2020