Shop Mobile More Submit  Join Login

Objective-C deviantART SDK

Wed Feb 5, 2014, 10:50 AM by Pickley:iconpickley:
We're happy to announce the release of version 1.0 of the Objective-C deviantART SDK. This SDK is a simple way to build great experiences using the deviantART API in your Mac or iOS apps.

Overview


The SDK requires iOS7 or OS X 10.9 and provides several classes for you to use and interact with:
  • DVNTAPIClient - The core of the SDK. This class provides the OAuth2 management along with core network calls.
  • DVNTAPIRequest - Provides simple wrapper methods around all API deviantART endpoints. If you find any that are missing, feel free to open a pull request to add them.

For the fastest integration, we recommend you use CocoaPods to install the SDK within your project, then simply import DVNTAPI.h with your codebase. DVNTAPI.h imports all the required headers for the SDK to function.


The Foundation


We have built the SDK upon the great foundation that is AFNetworking 2.0, a widely used networking library in the iOS community, this means that the SDK will work on the latest versions of Apple's operating systems, iOS7 and OS X 10.9. We believe this is the best choice as it will allow us not to be held back by the code of the past and allow us to move forward as needed.


CocoaPods


To install the SDK within your project, use the below Podfile then run pod install:

platform :ios, '7.0'
pod "deviantART-SDK", "~> 1.0.0"


DVNTAPIClient


Atop AFNetworking, we built a layer of OAuth 2.0 abstractions to allow authentication and interaction with the deviantART API. With two method calls to DVNTAPIClient, you can be fully authenticated and ready to make calls to the API.

Simply set your client's ID and secret in the SDK in applicationDidFinishLoading:

[DVNTAPIClient setClientID:@"__CHANGE_ME__" clientSecret:@"__CHANGE_ME__"];
Then authenticate using your client details by calling:

[DVNTAPIClient authenticateFromController:self scope:@"basic" completionHandler:^(NSError *error) {
  if(!error && [DVNTAPIClient isAuthenticated]) {
      // App is fully authenticated with no errors
      // and ready to perform API calls
  } else {
      NSLog(@"Error: %@", error);
  }
}];

After authentication is completed, you can make calls to any API endpoint you need and the SDK will handle authentication for you.


DVNTAPIRequest


Using DVNTAPIClient as a base, DVNTAPIRequest builds upon its basic GET/POST methods to provide simple methods to call upon any endpoint on the deviantART SDK. Here's an example of retrieving a delta from the Sta.sh API.

[DVNTAPIRequest deltaWithCursor:@"12345" offset:120 success:^(NSURLSessionDataTask *task, id JSON) {
       NSLog(@"JSON Response: %@", JSON);
} failure:^(NSURLSessionDataTask *task, NSError *error) {
       NSLog(@"Error: %@", error);
}];

DVNTAPIRequest covers all current API endpoints but if the need arises, you can use the GET/POST methods on DVNTAPIClient directly and authentication will still be handled completely by the SDK.


Documentation


For further documentation on getting started using the SDK, check the README file on GitHub. More in-depth Apple style documentation can be found here.


Open Source


The deviantART SDK is open source on GitHub and released under the BSD license. We will be accepting pull requests for changes from you, the community. Guidelines for issues, coding style and pull requests can be found in the project's README file.

We have also submitted the SDK to be available via CocoaPods, the biggest dependency manager for Objective-C projects. This will allow even simpler integration of the SDK into your current or new project.


Add a Comment:
 
:iconblueangel5383:
blueangel5383 Featured By Owner May 2, 2014
This is perfect timing.  I was wondering how I could manage favorites and watching list etc through the API's it doesn't look like the API expose those functionalities.  Please advise?
Reply
:iconpickley:
Pickley Featured By Owner May 22, 2014
Currently we have no API endpoints for such functionality. If you wish to have such functionality, I suggest emailing developers@deviantart.com with your suggestions along with how you plan to use them :).
Reply
:iconphoenixleo:
phoenixleo Featured By Owner Feb 14, 2014
I like how pretty it looks flying over my head.
Reply
:iconpickley:
Pickley Featured By Owner Feb 17, 2014
:woosh: by LeoLeonardo!
Reply
:iconphoenixleo:
phoenixleo Featured By Owner Feb 17, 2014
:iconsmilieplz:
Reply
:iconshadylink:
ShadyLink Featured By Owner Feb 12, 2014  Professional Interface Designer
This makes me so happy. :la:
Reply
:iconpickley:
Pickley Featured By Owner Feb 12, 2014
Awesome to hear!
Reply
:iconshadylink:
ShadyLink Featured By Owner Feb 18, 2014  Professional Interface Designer
I was working on a dA app waaay back, totally cheating by logging into a webview... I am so ashamed. But now I don't have to!
Reply
:iconpickley:
Pickley Featured By Owner Feb 18, 2014
Cannot wait to see what you build using this. Keep me posted about it :D
Reply
:iconshadylink:
ShadyLink Featured By Owner Feb 19, 2014  Professional Interface Designer
Will do :D
Reply
:icondeviant-garde:
deviant-garde Featured By Owner Feb 11, 2014
Despite not being a language I use myself (for the aforementioned reasons) I quite like the idea of what this is doing looking through the Cocoa Docs. I'm trying to imagine something like this in other languages.
Reply
:iconpickley:
Pickley Featured By Owner Feb 12, 2014
What would be some of the other languages you'd suggest?
Reply
:icondeviant-garde:
deviant-garde Featured By Owner Feb 12, 2014
Ruby and Python would be perfect, and your Java (for Android SDK) idea makes perfect sense too.
Reply
:icondivinityarcane:
DivinityArcane Featured By Owner Feb 15, 2014  Professional General Artist
Ruby is still actively used? :p did they finally fix how awfully inefficient the interpreter was?
Reply
:icondeviant-garde:
deviant-garde Featured By Owner Feb 15, 2014
Oh, they definitely kicked up the performance, both in 1.9 and 2.
Reply
:icondivinityarcane:
DivinityArcane Featured By Owner Feb 15, 2014  Professional General Artist
I'll have to look into it at some point in the future. How viable is it compared to things like Python?
Reply
:icondeviant-garde:
deviant-garde Featured By Owner Feb 15, 2014
I think it's used in many of the same domains, but people are preferring Ruby over Python for new web-centric things.
Reply
:icondivinityarcane:
DivinityArcane Featured By Owner Feb 16, 2014  Professional General Artist
..interesting. I know Rails caused a lot of sparks in the web dev arena, but I didn't think it'd become that widely used.
Reply
:icondeviant-garde:
deviant-garde Featured By Owner Feb 11, 2014
Now all I clearly need to do is buy a Mac or a new iPhone :plotting:
Reply
:iconpickley:
Pickley Featured By Owner Feb 12, 2014
Obviously you need both...
Reply
:icondeviant-garde:
deviant-garde Featured By Owner Feb 12, 2014
Oh, of course. :paranoid::dollarus::macos:
Reply
:icongiratte:
giratte Featured By Owner Feb 10, 2014  Hobbyist Digital Artist
Thumbs Up 
Reply
:icondivinityarcane:
DivinityArcane Featured By Owner Feb 10, 2014  Professional General Artist
I require additional Pylons.
Reply
:iconpickley:
Pickley Featured By Owner Feb 12, 2014
More pylons!
Reply
:icondivinityarcane:
DivinityArcane Featured By Owner Feb 12, 2014  Professional General Artist
:iconmoarplz:
Reply
:iconbaronbeandip:
baronbeandip Featured By Owner Feb 10, 2014
I agree.
Reply
Add a Comment:
 
×

:icondt: More from dt


Featured in Collections

README.TXT by Thunderstatement


More from DeviantArt



Details

Submitted on
February 5, 2014
Link
Thumb

Stats

Views
9,066 (7 today)
Favourites
9 (who?)
Comments
26
×