Skip to content

Latest commit

 

History

History
42 lines (31 loc) · 2.09 KB

README.md

File metadata and controls

42 lines (31 loc) · 2.09 KB
Raw

#HTTPRiot - Easily Consume REST Services

HTTPRiot is a simple HTTP library that works on the iPhone and Cocoa Apps. It tries to abstract as much as possible in the beginning. This means you don't spend a lot of time up front setting things up and staying on a golden path, but this also means it makes no assumptions about the data returned. It will convert JSON and XML automatically to NSDictionary or NSArray objects, allowing you to do what you want to with the data, but it's up to you to create your own models if you wish.

It offers a lot of flexibility with the data returned, but the tradeoff is that you must know what to do with the data returned because if you initiate two requests from one model both will be routed through the same delegate methods that handle responses/errors/etc.

This verson supports communication via SSL

In order to work with SSL you need to add Challenge Handlers. An example is provided by IMAuthentication

Documentation and Samples:

Quick Examples

// GET
[model getPath:@"/foo/bar.json" withOptions:nil object:nil];

// POST
NSDictionary *opts = [NSDictionary dictionaryWithObject:[obj JSONRepresentation] forKey:@"body"];
[model postPath:@"/foo" withOptions:params object:nil];

// PUT
NSDictionary *opts = [NSDictionary dictionaryWithObject:[obj JSONRepresentation] forKey:@"body"];
[model putPath:@"/foo/1" withOptions:params object:nil];

// DELETE
[model deletePath:@"/foo/1" withOptions:nil object:nil];

##Similar Projects HTTPRiot was inspired by the httparty Ruby library. There are also numerous other HTTP libraries for Cocoa: