I’m very concerned about the fact that many useful API endpoints in v5 of the API do not appear in the new API, such as the Search API, the Communities API, and the Teams API. (I’m also concerned about the Games API as without it the game_id returned by current APIs is mostly useless, but it appears that this is being explored according to the Roadmap.)
Is this simply down to not having yet implemented these APIs, or is there motivation for removing these?
I’m also confused by the docs. The Twitch API V5 stuff needs to be completely moved from https://dev.twitch.tv/docs to somewhere else. I don’t know which stuff is for the New API or which is for V5.
I also noticed a lack of endpoints that are in the V5 and V3. Likely as you said they are still implementing them in.
It seems that all the new stuff, as of now, is under the “New Twitch API” section, which is small as Twitch seems to continue developing that API based on Trello (Roadmap). I imagine that once they have it further developed, that we may see something like before that we can pick the version of the API that we want to review from a drop down, but, given that it is still very much in it’s [apparent] infancy, it seems that is why it is organized like it is.
Just my perception of this, someone from Twitch would have to weigh in.
The new API is far from done as the roadmap shows. One point of clarity is that the new Twitch API will not be at feature parity with v3/v5. This is a deliberate decision as we have just over 100 supported endpoints in v3/v5 but 97% of all usage is across 15 endpoints (kind of crazy, huh?). We’re focusing on fewer endpoints that are purposefully designed and provide value to developers.
For the website, we’re well aware that v5 has too much prominence for something that is deprecated. We’re fixing it.
I figured it out to this point. Just wanted to make sure about the details, because we are supposed to look at the roadmap. But roadmap doesn’t have some of features and it’s still a valid thing to know if parts not listed are going away.