Deviant Login Shop
 Join deviantART for FREE Take the Tour
Group Info Super Group Founded 13 Years ago Statistics 45 Members
345,787 Pageviews870 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

I prefer: 

27%
107 deviants said dont care
19%
75 deviants said july
15%
60 deviants said september
14%
57 deviants said june
13%
52 deviants said may
12%
46 deviants said august

Group Info

Super Group
Until Aug 13, 2014

Founded 13 Years ago
Oct 25, 2001

Location
Global

Group Focus
deviantART Related

45 Members
870 Watchers
345,787 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!
  • muteor synced 3 hours, 35 minutes ago
  • muteor synced 4 hours, 1 minute ago
  • ultramouse synced 5 hours, 30 minutes ago
  • yury-n synced 8 hours, 43 minutes ago
  • muteor synced 8 hours, 52 minutes ago
  • muteor synced 9 hours, 14 minutes ago
  • DEVlANT synced 14 hours, 1 minute ago
  • kemayo synced 17 hours, 3 minutes ago
  • sgrahamUK synced 1 day, 5 hours ago
  • muteor synced 1 day, 5 hours ago
  • muteor synced 1 day, 6 hours ago
Syncs Per Day

Comments


Add a Comment:
 
:icontemporaryneko:
temporaryneko Featured By Owner Jun 29, 2014  New member Hobbyist General Artist
Hi, my normal username is Neko-Ryuu, and I have been unsuccessful in trying to log in to that DA account for the past 2 days after being randomly logged out. I was wondering if you could fix this? I've tried changing passwords, but apparently that does nothing.
Reply
:iconbanks:
banks Featured By Owner Jul 3, 2014
Hi, sorry to hear you are having issues. The best place to go for help with that is our helpdesk: help.deviantart.com.

I'm sure you'll be back in in no time :)
Reply
:iconbrittleexistence:
brittleexistence Featured By Owner May 30, 2014  New member

Hello I recently sent in a file in the wrong help section.

Recently you have seemed to shrink the amount of design space for Premium custom boxes; ID; Wishlist; and favorites.

I would like to show you that my one coded; 600 width image shrunk to a size of roughly; 200 pixels.

Please fix this; its bothering and limiting tons of design space.

If you don't belive me write a journal upon seeing whom has the issues; everyone is pestered with a new html format?

If you would like to update the site of course its up to you; but could you give the members (even the premium members) unlimited space (width wise) to customize their pages for visual attractions?

So far the donation box is the only widget in which lets you have unlimited space until of recent; its also shrunk.

If you could even make it possible to where the members would have a choice in which they could pick if they want a shrunk format of a wide range it would be a compromise to fit all needs! But alas, the people in which pay for the memberships; don't even have the range to expand their money to produce the reason why we're all here.

" To design a layout that fits the needs and desires of all ".

Also a common quote is; "The customer is always right".

Although i'm not trying to impose my will of demanding such a 'right' back, it would improve your views on the overall page.

Because people want freedom to design their page just like their art, and when that freedom is 'restricted' tensions arise.

And I would hate to advise others to not support this website; leave a bad review; and also stop my memberships on other accounts; and leave the site.

So once more, please take this into consideration to let the members have some kind of range with varying widths; seeings its bad enough your forcing us to 'complete our profile' if you want the long widget/notification to go away. So please, i'm begging you, give us the freedom to design our pages to out personal tastes.

And not your own preferences; seeing this is deviantART. 
Not devinatBLOCK.


Thanks, 
Skyler.

Reply
:iconbrittleexistence:
brittleexistence Featured By Owner May 30, 2014  New member
Hi; I sent a help message before but seeing it was 'ignored' i'm going to try again. 
Reply
:icontreasures-of-wisdom:
Treasures-Of-Wisdom Featured By Owner May 29, 2014  Hobbyist General Artist
Maybe someone else reported this, but there is a bug with trying to look at the Full View version of my favorites instead of the scroll-bar version.  For example, what should look like this:

treasures-of-wisdom.deviantart…

Instead looks like this:

http//treasures-of-wisdom.deviantart.com/favourites/42917999

It's missing the colon after "http," and that makes the link unusable.
Reply
:iconjagtoons:
JAGTOONS Featured By Owner May 12, 2014
Very good!
Reply
:iconendorell-taelos:
Endorell-Taelos Featured By Owner Apr 27, 2014   General Artist
For some reason I've been able to give out two llamas to the same person in a row. :paranoid: :lol:
Reply
:iconkishan-bagaria:
Kishan-Bagaria Featured By Owner May 4, 2014
I did the same about a dozen times. =p
Reply
:icondj-telexture:
DJ-Telexture Featured By Owner Apr 23, 2014  Hobbyist General Artist

Hi, not reporting a bug, just suggesting something new. I'm a user who often favs a lot of art in one big hit, multiple times a day, and I was wondering if someone could place a small yellow star to the top of a thumbnail to show that you've already faved this piece. 

Say, I were to fav a piece from bloodkingowl, and a month later, I go through his gallery (and sometimes I forget if I've faved a piece and I go to fav it cause it something I liked), but then I see the little fav star icon and then it indicates that I've already faved, so it saves me a bit of time 

(and I could check by clicking the image and seeing if it was in my favourites, but this is mainly for fast browsing)

Is this suggestion able to go through? 

Reply
:icondahub:
dAhub Featured By Owner Apr 11, 2014
There's a bug in the watch list display that emerged within the past month.  I've tried filing a help desk ticket, but the response I received was dismissive and did not take this issue seriously, so I'll post the bug here in the hopes a developer will see it.

When clicking the "Next" button on the watch list, the 500th page is continuously displayed, regardless of which page you are on past 500.  With groups that approach 100,000 watchers, this prevents access to half of the watchers in the group.  Here are some example screen shots:
i.imgur.com/v6A0neT.png
i.imgur.com/X0ejOfA.png

There has been no announcement about a "500 page limit".  This feature has worked correctly for the past decade.  I really cannot fathom why this limit would suddenly be arbitrarily imposed, so this appears to be a mistake.  The "Next" button does not work as it should, so this is a bug with the site.

If someone could look into this, I would greatly appreciate it, thank you.
Reply
Add a Comment: