A standard that I’ve followed in the past is to use web services when the key requirement is speed (and data loss isn’t critical) and messaging when the key requirement is reliability. Like you’ve said, if the receiving system is down, a message will sit on a queue until the system comes back up to … Read more
Both approaches can be considered RESTful, provided you do not break the REST constraints defined in the chapter 5 of Roy Thomas Fielding’s dissertation: Client-server Stateless Cache Uniform interface Layered system Code-on-demand I cannot see major pitfalls in both approaches, but I would prefer the Approach B over the Approach A: the URLs are shorter, … Read more
Personally, both ways are acceptable…. however, if I were you, I’ll opt for option A (check read-only fields to ensure they are not changed, else throw an error). Depending on the scope of your project, you cannot assume what the consumers know about your Restful WS in depth because most of them don’t read documentations … Read more
The Sphinx Contrib project also seems to have an HTTP Domain package for documenting RESTful HTTP APIs. You can find its documentation on the Python packages site. I can’t speak to its fitness: I’m only just starting to look into Sphinx, and I have a need to document RESTful APIs as well, and noticed this … Read more
@ApiImplicitParams and @ApiImplicitParam should do the trick: @GET @Produces(“application/json”) @ApiImplicitParams({ @ApiImplicitParam(name = “Authorization”, value = “Authorization token”, required = true, dataType = “string”, paramType = “header”) }) public String getUser(@PathParam(“username”) String userName) { … } From the documentation: You may wish you describe operation parameters manually. This can be for various reasons, for example: Using … Read more
Methods .fetch(), .save() and .destroy() on Backbone.Model are checking if the model has .sync() defined and if yes it will get called otherwise Backbone.sync() will get called (see the last lines of the linked source code). So one of the solutions is to implement .sync() method. Example: var User = Backbone.Model.extend({ // … methodToURL: { … Read more
Consider contains: $filter=contains(CompanyName,’Alfreds’)
I believe Resource Owner Credentials flow should be avoided unless really needed AND the client app and environment are under your own full control. You may have full control over the app but you cannot control the phone OS (security updates, …) This blog post goes over the various problems. I do not fully agree … Read more
According to graphql documentation there are more than one pagination model. GitHub is using complete connection model In this model you can traverse with adding after:”Y3Vyc29yOjEwMA==” to your search query. query { search(first: 100, after:”Y3Vyc29yOjEwMA==”, type:USER, query:”location:usa repos:>0 language:java”) { pageInfo { startCursor hasNextPage endCursor } userCount nodes { … on User { bio company … Read more
This question is primarily opinion-based. But from my experience: Multiple requests on a RESTful-API for just one thing often indicates a lack in the API design, namely the needed resource was not available and therefore stuff needs to be gathered from different resources to compensate for this. A REST-API that could be easily replaced by … Read more