Of the three I prefer the third option, it’s not uncommon to see that syntax; e.g. parts of Twitter’s API allow that syntax: https://dev.twitter.com/rest/reference/get/statuses/show/id A fourth option is a hybrid approach, where you pick one (say, ID) as the typical access method for single items, but also allow queries based on the slug. E.g.: GET … Read more
The OEIS now provides several points of access, not just ones using their internal format. These seem largely undocumented, so here are all of the endpoints that I have found: https://oeis.org/search?fmt=json&q=<sequenceTerm>&start=<itemToStartAt> Returns a JSON formatted response of the results found from the sequenceTerm given. If too many results were returned, count will be > 0 … Read more
The threat that someone gets the database and gets the keys means they can use the api keys to access the data in the database, which they already have, so no win there. The threat that someone can access the database, get the passwords, means they can reuse those passwords on other web sites with … Read more
The expected behavior in this case, as per the HTTP spec and by REST guidelines, would be to return 405 Method Not Allowed. The resource is there, since a GET works, so a 404 Not Found would be confusing. I’m not familiar with the GitHub API but in some cases I see that for 403 … Read more
Service Oriented Architecture is an architectural methodology. It is a way of specifying separation of responsibility from a business oriented point of view into independent services, which communicate by a common API (often but not necessarily by publishing events to a bus). As an example, you could have one service responsible for capturing customer orders, … Read more
The major version number is all you need for a web service. Because your consumers are only concerned about backward incompatible changes, and (if you’re following semantic versioning correctly) those will only be introduced when a new major version is released. All other changes (including new features, bugfixes, patches etc.) should be ‘safe’ for your … Read more
Enrico Service looks promising, at least for little site without high reliability demand
There are 2 ways of saving the response to a file: Click on the small down arrow besides the “Send” button, this will show the “Send and Download” button. Click on it and postman will ask you where to save the response, when the request is done. There is a “Download” button in the response … Read more