September 2018
Intermediate to advanced
764 pages
20h 6m
English
Related endpoints should be grouped. For example, the Instagram API groups endpoints into user-, media-, tags-, and location-related endpoints, each under api.instagram.com/v1/{group}/.
This makes it easy for the consumer of the endpoint to immediately be able to deduce the intended function of the endpoint, without having to refer to the documentation. The function of the endpoint should be obvious to the consumer.
For example, it's immediately obvious that /users/:user-id/media/recent is an endpoint that retrieves the most recent media objects of a user.
Read now
Unlock full access