אימות ישויות עם סכימות JSON

כדי לאמת ישויות כשיוצרים או מעדכנים את הפיד, צריך להשתמש בקובץ ה-JSON הבא סכימות. הסכימות מבוססות על מפרט סכימת JSON. על ידי הוספת בדיקת יחידה כדי לאמת את הישויות שאתם יוצרים, תוכלו לגלות שעלולות להשפיע על איכות הפיד. תוכלו להשתמש בסכימות האלה גם פיתוח הפיד כדי להימנע משגיאות נפוצות.

בחירת סכימה של פעולות מדיה

• סכימת וידאו לפי דרישה מאמתת ישויות Movie, TVEpisode, TVSeries ו-TVSeason.
• סכימת הטלוויזיה בשידור חי מאמתת את הישויות BroadcastEvent, BroadcastService, CableOrSatelliteService, Movie, Organization, SportsEvent, TelevisionChannel, TVEpisode, TVSeason ו-TVSeries.
• סכימת מוזיקה מאמתת את הישויות MusicAlbum, MusicGroup, MusicPlaylist ו-MusicRecording.
• סכימת רדיו מאמתת RadioBroadcastService ישויות.

השתמשו במפרט באתר הזה כמקור האמת, מכיוון שייתכן שסכימות אלה לא מיושמות בכל התכונות.

בחירת כלי אימות

אתם יכולים למצוא רשימה של הטמעות של כלי התיקוף בכתובת json-schema.org.

הסכימות שסופקו כתובות בטיוטה 7, כך שההטמעה שבוחרים צריכה לתמוך בגרסה הזו כדי לפעול כראוי.

דוגמה לאימות

בדוגמה הבאה אפשר לראות איך לאמת את כל הישויות שבקובץ feed.json באמצעות קובץ הסכימה schema.json ומודול ה-python jsonschema. הישויות נמצאות מאפיין dataFeedElement כפי שצוין בתיעוד של מעטפה של פיד נתונים.

    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")