Sam Ruby: Progressive Disclosure

PUT means update the resource with this entity, which tends means "overwrite". Now think for a moment about how that works for things like tags in a blog post - if I leave the tag out, am I saying remove it? Ignore it? Do I have to echo back all t...

When you build a JSON API you need to come up with a style to represent attributes, pagination, errors or including associated objects. Instead of reinventing the wheel, you may reuse successful API designs.

JSON API

[JSON:API](https://...

So, as a result, people using RESTful ideas to talk to browsers have to put the smarts back on the server. They invent new URLs which (for example) return a resource, but return it all wrapped up in the HTML needed to display it as a form for brow...

If a SOAP API expects you to call a remote method with arguments of complex types, Savon lets you manually set the xsi:type attribute like this:

client.call(:rpc_method,
  message: {
    :some_object => {
      :n...

Most of the problems with cookies are due to breaking visibility,

I have been playing around with RESTful Rails recently. Below is my collection or Rails REST howtos, tutorials and other resources I have found so far.

Awesome library to consume web services in Ruby.

In my career, I have consumed hundreds of REST APIs and produced dozens. Since I often see the same mistakes repeated in API design, I thought it might be nice to write down a set of best practices. And poke fun at a couple widely-used APIs.

...

Once you start introducing partial updates, you open yourself for caching problems. doing partial updates means all cached copies of the original resource are now invalid.

A rough guide how to implement a REST API.

The discussion here includes some interesting points as well:

• Timestamps: ISO8601 format ("2021-02-22T20:34:53.686Z")
• Google API guideline: <htt...