Ever wanted to call FullContact's API from your own iOS or OS X application? Now you can.

fullcontact-objc is a library for iOS and Mac OS X. It's built on top of AFNetworking and provides connectivity to the FullContact Developer API endpoints.

###Why we love it… fullcontact-objc makes it painless to access the FullContact Developer API in your iOS or Mac OS X apps - in fact, we use it ourselves in our own apps such as FullContact Card Reader.

Currently this library has support for the following FullContact endpoints:

fullcontact-objc requires either iOS 5.0 and above, or Mac OS 10.7 (64-bit with modern Cocoa runtime) and above.

###Installation CocoaPods is the recommended way to add fullcontact-objc to your project.

1. Add a pod entry for fullcontact-objc to your Podfile pod 'fullcontact-objc', '~> 1.0.0'
2. Install the pod(s) by running pod install.
3. Include fullcontact-objc wherever you need it with #import "FCAPI.h" or any of it's subcategories.

fullcontact-objc uses ARC.

If you are using fullcontact-objc in your non-arc project, you will need to set a -fobjc-arc compiler flag on all of the source files.

To set a compiler flag in Xcode, go to your active target and select the "Build Phases" tab. Now select all fullcontact-objc source files, press Enter, insert -fobjc-arc and then "Done" to enable ARC for fullcontact-objc.

To initialize the API, simply import FCAPI.h. Ensure you have the following constants defined:

1. kAPIUrl is "https://api.fullcontact.com"
2. kAPIVersion is "v2"
3. kAPIKey is the API Key that you obtained from FullContact.

Then call:

FCAPI *api = [[FCAPI alloc] initWithBaseURL:[NSURL URLWithString:kAPIUrl] andVersion:kAPIVersion andAPIKey:kAPIKey];

To use the API after it is initialized, simply import the category that you wish to use and invoke one of the methods. For example, if you'd like to look up a person by their email address you could do the following:

Add the following to your imports:

#import "FCAPI+Person.h"

After initializing your API instance, call the lookupByEmail method as follows:

[api lookupByEmail:@"[email protected]" success:^(FCResponse *response) {
      //response.response will contain your JSON payload which you can handle here
} 
failure:^(FCResponse *response, NSError *error) {
      //handle the error that may have been returned
}];

To run fullcontact-objcTest, simply locate the TestContstants.h file in the fullcontact-objcTest project and insert your API key as the value for kAPIKey. After doing this you can run tests for both iOS and OSX architectures.

Note that Card Reader tests only function for the iOS platform at this time.

##Need Help - No Problem! We're always available to help in any way we can. Check out our Support Page to access our Knowledge Base or contact our Support group.

##Got an Idea? We love ideas! Submit your ideas, suggestions, or feedback on our API Developer Forum or fork our repo. We review pull requests regularly and look forward to seeing what you come up with!

fullcontact-objc is available under the Apache License Version 2.0 license. See the LICENSE file for more info.