Bugs in some API documentation


#1

In REST API v1.1, response objects of “GET statuses/retweets/:id” should be retweets of given tweet.
However, in the example request of documentation, the response is a group of users.

Another bug is in documentation of “GET statuses/show/:id”. According to name of this API, the format should be
https://api.twitter.com/1.1/statuses/show/:id.json
But doc said that tweet ID should be in request parameters.
I tried these two format and found both ok.
So which one is deprecated?

Thanks!


#2

Thanks for the note about that doc bug, I’ll fix it.

The statuses/show method “signature” still allows for including tweet IDs directly inline in the path of the resource, but overall we prefer the parameterized approach as it is more deliberate and explicit. You can use either approach interchangeably in version 1.1 depending on your own preferences.