Inconsistence between documentation & usage


#1

Hello,

I’m working with the twitter Public API right now,
I spotted some inconsistencies:

  • There is 95 endpoints documented in the Public API (most of them with rate limit).
  • Only 36 are documented in the rate limit charts.
  • A call to the application/rate_limit return 76 endpoints rate limit informations.

From the call to the api rate limit, I have some totally undocumented endpoints like:
/contacts/addressbook
/contacts/delete/status
/contacts/uploaded_by
/contacts/users
/contacts/users_and_uploaded_by

Also, the call doesn’t return rate limit for endpoints documented as rate-limited.

You can find on this gist the list of all endpoints:

I didn’t push the analyse further, but is there any way to get a find a documentation of the api ? Even a technical schema would be fine (json schema of the API etc).