Shop Mobile More Submit  Join Login
Group Info Group Founded 14 Years ago Statistics 46 Members
383,274 Pageviews899 Watchers
COGS #2 by Z-GrimV
We are happy to announce the release of an improved Sta.sh API. After many years the Sta.sh api had become a little confusing and was not keeping up with changes to its backend systems. We therefore decided to redesign parts and fix some of the confusing naming and behaviour.

These changes are versioned so if you are using version prior to 20150416 there will be no change in behaviour, we plan to support the old api for around a year.

Summary of Changes

The folderid and stashid fields have been replaced by stackid and itemid respectively, this change applies to all endpoints.

These endpoints were removed and their functionality is provided by newer ones

  • /stash/folder
  • /stash/media
  • /stash/metadata
  • /stash/move/file
  • /stash/move/folder

New endpoints to manage stacks

  • POST /stash/move/{stackid} - moves stacks
  • POST /stash/position/{stackid} - change the position of a stack within a parent stack
  • POST /stash/update/{stackid} - update stack details (title, description)
  • GET /stash/{stackid} - fetch stack details, returns stash_metadata object
  • GET /stash/{stackid}/contents - list stack contents, supports pagination

New endpoints to manage items

  • GET /stash/item/{itemid} - fetch an item, returns stash_metadata object
  • POST /stash/delete - delete an item by itemid

Stash Metadata object

  • Renamed fields folderid and stashid
  • Removed is_folder
  • Replaced keywords with tags

Any problems can be reported on the GitHub Issue Tracker.

Header artwork: COGS #2 by Z-GrimV


More Journal Entries

Group Info

Group
Founded 14 Years ago
Oct 25, 2001

Location
Global

Group Focus
deviantART Related

46 Members
899 Watchers
383,274 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:
 
:iconlaserraptorcoderman:
LaserraptorCoderman Featured By Owner Sep 24, 2015  Hobbyist General Artist
Wouldn't e-mail notification be practical?
I'm fairly new to this site but see there used to be a script & and interface before?
zilla774.deviantart.com/art/dA… How about that, or just simply the option to be notified by e-mail as well (it could bring back inactive members by reminding them? :) )
Reply
:iconmiloticscale:
MiloticScale Featured By Owner Oct 25, 2015  Hobbyist Digital Artist
...notifications for what?
Reply
:iconlaserraptorcoderman:
LaserraptorCoderman Featured By Owner Oct 26, 2015  Hobbyist General Artist
... for a start; feedback & notes (simply put; the same events that add to the Notes & the Feedback counters on your account, the ones shown when browsing online).
Ideally one should be able to choose which events that triggers e-mail, and preferably whether to send on a per event basis, or just send i.e. a weekly summary (grouped listing of notes in one e-mail).

How about that?
Reply
:iconmiloticscale:
MiloticScale Featured By Owner Oct 26, 2015  Hobbyist Digital Artist
That sort of defeats the purpose of having an on-site message center, doesn't it?

I'd agree maybe with the weekly summary as long as it only included unread messages. I get way to many feedback messages/notes on a regular basis to be for being notified on each. Perhaps instead a system that lets a message sit pending for at least a certain amount of time before emailing you. :nod:
Reply
(1 Reply)
:iconthaidaree:
Thaidaree Featured By Owner Aug 27, 2015
Hello, is it possible to get a list of items in scraps and how? If I get things correctly, oEmbed is for single items, the API has no scraps endpoint anywhere (or I could be blind). The RSS can display it but I don't know how to construct the url to display only scraps from a specific user...
Reply
:iconthaidaree:
Thaidaree Featured By Owner Sep 3, 2015
Found it, but it would be great if CORS could be enabled for RSS links.
Reply
:iconkaylakedziora:
KaylaKedziora Featured By Owner Aug 8, 2015  Hobbyist Digital Artist
Reply
:icondust258:
dust258 Featured By Owner Jul 8, 2015
I don't get paragraph 6 (Attribution) of the API License agreement. I have to display a license attribute on every page which uses deviantart content. But where do I get the attribute? Username + Link to the picture?
See: about.deviantart.com/policy/ap…
Reply
:iconlululock71:
lululock71 Featured By Owner Jun 22, 2015  Hobbyist General Artist
Where can I propose ideas for DA ?
Reply
:iconmiloticscale:
MiloticScale Featured By Owner Oct 6, 2015  Hobbyist Digital Artist
Reply
Add a Comment: