Rose colored stained glass windows for HTTP.
Don't cover up the web; just fill in the gaps here and there. Make it easy to add links and other affordances API publishers might have forgotten.
Don't try to make the web look like a database.
Resources are the server's job to worry about. The things we get back from a server are representations. Take representations at face value and interpret them sensibly, rather than trying to fit them into a client-side model of an imaginary server-side object graph.
Always try to convert representations returned by the server into a form that is useful to the programmer--whether that is a Hash parsed from JSON data, a Nokogiri document, or a text string.
Using the power of Faraday.
Only raise exceptions in API calls which explicitly request them. Provide ample information to explain the cause of a failure.
Architected from the ground up with asynchrony in mind. It's easier to build a synchronous API on top of an async one than vice-versa.
All abstractions are leaky. Provide ample and convenient access points into the guts of the request lifecycle for situations when the defaults are not sufficient.
See leadlight_spec.rb for now.