Tagged Questions
19
votes
8answers
1k views
“Public APIs are forever: Only one chance to get it right”?
In an OS book I just read that, "Public APIs are forever: Only one chance to get it right". Is it true? Is it applicable only in APIs of Operating Systems or other APIs too? For example, will this be ...
6
votes
1answer
2k views
When to use nested resources in a RESTful API
I have two resources: users and links.
Users can have several links associated with them. I have designed my RESTful API so that you can reach the links associated with a user at the following URI:
...
3
votes
3answers
366 views
API method placement guidelines?
Are there any guidelines for placing methods in API when the placement isn't obvious?
Example: I have classes A and B and a method X. The work being carried out can be phrased in two ways:
A does X ...
