Documentation: Get all movie translations

[martinr92]

Hello,

There is an issue in the documentation for the "Get all movie translations" endpoint: The language field is marked as required, but it is optional.

https://docs.trakt.tv/reference/getmoviestranslations

Regards,
Martin

[kevincador]

Thanks for reporting this. You’re correct that the API accepts this endpoint both with and without the language segment.

Unfortunately, OpenAPI requires every path parameter to be marked as required, so it cannot directly represent an optional path segment such as this one. The documentation is generated from our OpenAPI definition, which is why language appears as required.

Correcting the display would require documenting the filtered and unfiltered URLs as two separate operations, which I think is overkill. Maybe this can be solved with an "all" language keyword or with a query param instead of a path param. @vladjerca I'd like to have your opinion on this one 👀

Thanks again for flagging the discrepancy.

[martinr92]

Oh, there are several APIs having the same issue. Nur sure, if all might work for others as well.

From a API design it would make more sense to replace them with query parameters instead of URL?