Shop More Submit  Join Login
Group Info Group Founded 13 Years ago Statistics 47 Members
353,992 Pageviews874 Watchers

API Updates

Thu May 8, 2014, 10:52 AM
We are pleased to announce the release of a new API backend framework and documentation to support future growth of the deviantART & Sta.sh API's.

New Docs2 by muteor

Endpoint2 by muteor



Whats Changed?


We have been busy over the past few months creating a new framework that will allow us to make changes to the API faster.

The main new features are:
  • Versioning - We now support versioning of endpoints meaning we can make backwards incompatible changes.
  • Error Responses - We have standardized our error responses to make it easier for you to handle errors.
  • Request Specifications - We now have fine grained endpoint parameter specifications that improve request validation greatly.
  • Response Specifications - Responses are now predefined so your client will always receive consistent responses and types from the API.
  • Automated Documentation - All of the above means we can auto-generate documentation so that it doesn't become out of sync when we make changes.

Versioning


The ability to version changes to the API is one of the more important new features as it means we can now make backward incompatible changes without breaking older client implementations.

Major versions are specified via the URI of the endpoint and the current major version is v1, for example the whoami call is now: 
/api/v1/oauth2/user/whoami
Minor versions are date based E.g. 20140101 and are requested via the special request header dA-minor-version. If you do not send the header your client will always receive the latest minor version available.

Note: You do NOT need to update your current clients, all requests that do not contain the /v1/ major version in the URI are locked to v1.0 automatically.

Check out the full versioning documentation.

Errors


One of the more inconsistent parts of the old API was its error messages, we have now simplified the error codes and returns to make it easier for your clients to handle error states.

Old style errors are still returned if the request does NOT contain /v1/ in the URI. These will be documented with the endpoint and are marked as deprecated. 

Check out the full errors documentation.

The Future


The point of all this work is to make it possible to release new endpoints in the future. So far we are carefully testing the framework and considering what new endpoints can be released. We don't take the decision to release a new endpoint lightly - it is something that must be well designed, coherent and easy to use and something that we must support for a long time to come.

If you have a burning desire for a particular endpoint that would allow you to do something awesome, then we'd love to hear your thoughts. Please bear in mind that we will only be releasing new endpoints once we are confident that they will work well, be useful to a wide audience and be something we can support log term.

 

More Journal Entries

Group Info

Group
Founded 13 Years ago
Oct 25, 2001

Location
Global

Group Focus
deviantART Related

47 Members
874 Watchers
353,992 Pageviews
Daily Pageviews

Sync

When DT finishes making a brand new deviantART feature, or just fixes a bug, we first run it on our top-secret staging server. When everything's ready to go live, we sync it!
Syncs Per Day

Comments


Add a Comment:
 
:iconzvoc47:
Zvoc47 Featured By Owner Aug 13, 2014  Hobbyist Digital Artist
Hello, this group's icon is interesting. When I scroll, I see text behind it that is static, giving a picture of moving code. How did you do that? Is it you or just a glitch on my graphics card?
Reply
:icongreyroseofhope:
GreyRoseOfHope Featured By Owner Sep 20, 2014  Hobbyist Writer
...oh my gosh it's a window into the background of dA! We've broken through the fourth wall in our computer screens!
Reply
:iconzvoc47:
Zvoc47 Featured By Owner Sep 21, 2014  Hobbyist Digital Artist
yeah. It could also be something like a devious blackhole
Reply
:iconvanuinfiltrator:
VanuInfiltrator Featured By Owner Sep 12, 2014  Hobbyist Writer
Holy crap, I just noticed that! :lol:
Reply
:iconzvoc47:
Zvoc47 Featured By Owner Sep 14, 2014  Hobbyist Digital Artist
it also appears on my phone
Reply
:iconyumeruby:
yumeruby Featured By Owner Aug 19, 2014  Hobbyist General Artist
It's us ;) Our icon has 2 layers combined through css.
Reply
:iconzvoc47:
Zvoc47 Featured By Owner Aug 20, 2014  Hobbyist Digital Artist
Wow. Does the file itself have css or is the css file on deviantART site or is it on this page? When I use it as an icon, it still has background. :icondt:
Reply
:iconyumeruby:
yumeruby Featured By Owner Aug 20, 2014  Hobbyist General Artist
It's part of the site css, so it works everywhere.
Reply
(1 Reply)
:iconmidnight-fistfight:
Midnight-Fistfight Featured By Owner Aug 19, 2014   Digital Artist
It does it on my computer too! :O that's so crazy!!!!!!
Reply
:iconzvoc47:
Zvoc47 Featured By Owner Aug 19, 2014  Hobbyist Digital Artist
idk, but I think
:icondt::icondt::icondt::icondt::icondt::icondt::icondt:
:icondt::icondt::icondt::icondt::icondt::icondt::icondt:
:icondt::icondt::icondt::icondt::icondt::icondt::icondt:
:icondt::icondt::icondt::icondt::icondt::icondt::icondt:
if I modify that picture and make it a plz account, that would be very crazy when you'd post that on your journal for example XD
Reply
Add a Comment: