Deviant Login Shop
 Join deviantART for FREE Take the Tour
About Photography / Hobbyist Administrator MY NAMEOther/United Kingdom Groups :iconhq: hq
deviantART Headquarters
Recent Activity
Deviant for 2 Years
Premium Member 'til Hell freezes over
Statistics 19 Deviations 180 Comments 33,990 Pageviews

Newest Deviations

Favourites

Visitors

API Updates

Tue May 6, 2014, 2:47 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.

 

Journal History

deviantID

muteor's Profile Picture
muteor
MY NAME
Artist | Hobbyist | Photography
United Kingdom
dfdfgfgf
Interests

Groups

Comments


Add a Comment:
 
:iconmuteor:
muteor Featured By Owner Apr 18, 2014  Hobbyist Photographer
.....
Reply
:iconmelito2010:
melito2010 Featured By Owner Apr 6, 2014
petitions.whitehouse.gov/petit…

www.avaaz.org/en/stop_the_corp…

action.sumofus.org/a/australia…

you better tell the others too it's not a joke it's serious or will be the end of deviantart.

But better start to tell the others too
Reply
:iconmuteor:
muteor Featured By Owner Apr 2, 2014  Hobbyist Photographer
comments are fun
Reply
:iconmuteor:
muteor Featured By Owner Mar 27, 2014  Hobbyist Photographer
...
Reply
:iconmuteor:
muteor Featured By Owner Mar 27, 2014  Hobbyist Photographer
....
Reply
:icongrakusart:
GrakusArt Featured By Owner Jan 30, 2014  Hobbyist Traditional Artist
:iconthank-youplz: 
Reply
:icondreamon-mpak:
DreamON-Mpak Featured By Owner Dec 25, 2013  Hobbyist Digital Artist
With this message I want to thank you for the great work you apply each year to keep this wonderful site.. Over the past 2013 years there were many changes .. some changes were not well received by users (such as changing the symbols to our names) .. some of the changes were sad (closure of DeviantGEAR) .. But we know that you do in order to keep the website up and there giving us the opportunity to present our work in the most - the best way.. We're grateful for every minute of your time that you spend on this site..I hope you will spend with your family and friends some amazing holidays and  new year be wonderful for you.. Filled with personal and professional success.. Much love, health, happiness and luck.. Thank you again .. Your work moves forward this site.. We appreciate your work..

This message it send to each member of DA Team  .. Always remember that you are an amazing team .. As individuals you are amazing people .. as a team you create miracles.. Together you can do much more, and you prove it every year.. Be always Deviants..
Happy Holidays DeaviantART Team .. We users ot this site  love you and always will support you .. :aww:
Reply
:iconrhynwilliams:
RhynWilliams Featured By Owner Nov 18, 2013   Traditional Artist
cute dog! :heart:
Reply
:iconforestdwellerhouses:
ForestDwellerHouses Featured By Owner Nov 4, 2013  Professional Artisan Crafter
Thank you for all your help on DA!Clap
Reply
:iconrattyredemption:
rattyredemption Featured By Owner Oct 23, 2013
i just wanted to express my gratitude for your spam account filter. it's made a significant improvement to the quality of the time spent here at da.
Reply
Add a Comment: