Discrepancy in API Documentation for Season Endpoints

[y1ndan]

I have been working with the Trakt API and noticed some discrepancies in the documentation regarding the season endpoints. Specifically, I am referring to the following endpoints listed in the documentation:

1. /shows/:id/seasons: Get all seasons for a show

2. /shows/:id/seasons/:num/info: Get single season for a show

3. /shows/:id/seasons/:num: Get all episodes for a single season

According to RESTful conventions, the third endpoint (/shows/:id/seasons/:num) seems like it should return a single season for a show, similar to the second endpoint. The URL format for retrieving all episodes of a season seems more appropriate as /shows/:id/seasons/:num/episodes.

In fact, I have discovered that the endpoint /shows/:id/seasons/:num/episodes does exist and works correctly, but it is not mentioned in the documentation.

Furthermore, in the Website Media Links section of the documentation, it is stated that:

Type	URL
movie	/movies/:slug
show	/shows/:slug
season	/shows/:slug/seasons/:num
episode	/shows/:slug/seasons/:num/episodes/:num
person	/people/:slug
comment	/comments/:id
list	/lists/:id

According to this, the URL /shows/:slug/seasons/:num should return a season, but in reality, it returns all episodes for that season.

Could you please clarify the intended use of these endpoints and update the documentation accordingly? It would be helpful to have consistent and accurate information to avoid any confusion.

Thank you.