Valider des entités à l'aide de schémas JSON

Pour valider des entités lorsque vous créez ou mettez à jour votre flux, utilisez les schémas JSON suivants. Les schémas sont basés sur la spécification du schéma JSON. En ajoutant un test unitaire pour valider les entités que vous générez, vous pouvez détecter les problèmes qui affecteraient la qualité du flux. Vous pouvez également utiliser ces schémas lors du développement de votre flux pour éviter les erreurs courantes.

Sélectionner un schéma d'actions multimédias

• Le schéma de la vidéo à la demande valide les entités Movie, TVEpisode, TVSeries et TVSeason.
• Le schéma de télévision en direct valide les entités BroadcastEvent, BroadcastService, CableOrSatelliteService, Movie, Organization, SportsEvent, TelevisionChannel, TVEpisode, TVSeason et TVSeries.
• Le schéma Music valide les entités MusicAlbum, MusicGroup, MusicPlaylist et MusicRecording.
• Le schéma Radio valide les entités RadioBroadcastService.

Avertissement :Les spécifications TVSeries, TVSeason, TVEpisode et Movie diffèrent entre la VOD et la TV en direct. Utilisez le schéma qui correspond à l'utilisation prévue de l'entité ou le schéma VOD si l'entité est utilisée en tant que VOD et TV en direct.

Utilisez la spécification de ce site comme source de vérité, car il est possible que toutes les fonctionnalités ne soient pas implémentées dans ces schémas.

Sélectionner un validateur

Vous trouverez la liste des implémentations de validateurs sur json-schema.org.

Les schémas fournis sont rédigés en version préliminaire 7. L'implémentation que vous choisissez doit donc être compatible avec cette version pour fonctionner correctement.

Avertissement :Nous ne pouvons approuver aucune implémentation. Il vous incombe de choisir parmi les implémentations existantes et de vous assurer qu'elles s'exécutent de manière sécurisée dans votre processus.

Exemple de validation

L'exemple suivant montre comment valider toutes les entités présentes dans un fichier feed.json à l'aide du fichier de schéma schema.json et du module Python jsonschema. Les entités se trouvent dans la propriété dataFeedElement, comme indiqué dans la documentation sur l'enveloppe du flux de données.

    import json
    from jsonschema import validate

    # Loading the schema file
    with open("schema.json", "r") as fp:
        schema = json.load(fp)

    # Opening the feed
    with open("feed.json", "r") as fp:
        feed = json.load(fp)

    # Validating each entity in the feed
    for entity in feed["dataFeedElement"] :
        try:
            validate(schema=schema, instance=entity)
            print("Entity validated successfully")
        except Exception as e:
            # e may contain an explanation as to why the entity wasn't valid
            print("Failed to validate the entity")