API: Change show.seasons structure

[sharkykh]

Related to this discussion.

Option 1:

An object where the keys are the season numbers (as strings because JSON doesn't support key indices)

"show": {
    "seasons": {
        "0": [
            { episode1 (object) },
            // ...
            { episodeN (object) }
        ],
        "1": {
            { episodeN (object) }
        },
        // ...
    }
}

Option 2:

An array of objects

"show": {
    "seasons": [
        {
            "season": 0,
            "episodes": [
                { episode1 (object) },
                // ...
                { episodeN (object) }
            ]
        },
        { season1 (object) },
        // ...
    ]
}

[p0psicles]

I would go with option 1. As its a little unlogic to get a specific season having to loop over them.

[p0psicles]

I had to search a little. But it seems we share an opinion.

[sharkykh]

@p0psicles Yeah the first option was actually my second suggestion, so I do like it better than the other option.

[sharkykh]

Ughh...
patternProperties isn't supported by OpenAPI (both 2.0 and 3.0).
If it isn't supported, we can't really use in the API definition, which is a problem...