README.md in apisync-0.1.4 vs README.md in apisync-0.1.5

@@ -46,9 +46,22 @@
 
 # Instantiate the client now without passing a token
 client = Apisync.new
 ```
 
+### Responses
+
+All HTTP calls return an
+[HTTPart::Response](https://github.com/jnunemaker/httparty) instance:
+
+```ruby
+response = client.inventory_items.save(attributes)
+response.success? # => true
+```
+
+In case too many requests are made simultaneously, the server will return
+429 and this lib will raise the `Apisync::TooManyRequests` exception.
+
 ## Development
 
 To run tests:
 
 ```