You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Current OpenAPI documentation seems to be generated by deno task openapi:generate and this produces a huge document.
The output document is over 70.000 lines long and contains no schemas for response objects or parameters which are all inline.
I believe providing schemas would be massively beneficial both for the usage of the API and the developers who may wish to integrate their app with Trakt as it would provide a clear source of truth for structures returned by the API and a clear documentation on required and optional parameters as well as validation for these parameters.
Aligned with this issue is the fact that the current OpenAPI document isn't aligned with the documentation provided in the official Trakt API Blueprint which still seems to be the official reference.
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
Uh oh!
There was an error while loading. Please reload this page.
-
Current OpenAPI documentation seems to be generated by
deno task openapi:generateand this produces a huge document.The output document is over 70.000 lines long and contains no schemas for response objects or parameters which are all inline.
I believe providing schemas would be massively beneficial both for the usage of the API and the developers who may wish to integrate their app with Trakt as it would provide a clear source of truth for structures returned by the API and a clear documentation on required and optional parameters as well as validation for these parameters.
Aligned with this issue is the fact that the current OpenAPI document isn't aligned with the documentation provided in the official Trakt API Blueprint which still seems to be the official reference.
Beta Was this translation helpful? Give feedback.
All reactions