Now an open API, woo!
I hear things. I know of at least five other sites that were at one point working on big fancy things that involve wearables data. And it feels odd to be open enough to offer the code, but not open enough to offer the data. After all, I’m just one guy—a wearables app run by a whole staff is much more likely to keep up with all the latest data and be able to take care of the nonsense that is MME items.
As such, I’m pleased to announce that /objects.json and /object_assets.json are now officially open APIs. Hoorah!
There isn’t any formal documentation for these points of access, for two main reasons. First off, I don’t have time to write up formal documentation for one or two people who might actually use it. Senior year is a busy time, dontchaknow. Second, if you’re familiar with the sort of data involved with wearables, it should be mostly self-explanatory, anyway.
To get information about object #123 and object #234, access: /objects.json?ids[]=123&ids[]=234
Output will be an array of objects in JSON form, and include basic data such as name, thumbnail_url, description, rarity, and zones_restrict. (If you’ve been working with wearables, you know the syntax: if there were four zones, 0110 would mean zones 2 and 3 are restricted.)
To get SWF data for object #123 and object #234 on body type #84 (the standard Bori), access: /object_assets.json?body_id=84&parent_ids[]=123&parent_ids[]=234
Output will be an array of SWF assets, with various attributes, including a parent_id attribute linking it to its parent, is_body_specific for a guess as to whether this object can fit all body types or just this one (based on the type attribute of the zone it belongs to), and where on the Dress to Impress server the SWF file resides, since, due to Flash’s security restrictions, the original SWF files had to be copied to our own server for us to be able to display them properly. You can download directly from us if you like, or, if you need the original SWF URL, you can likely perform a simple transformation, since our URL scheme very closely parallels TNT’s.
Note that some Dress to Impress data may be inaccurate. MME items are never to be trusted, and sometimes SWF assets act as if they fit all body types when they really do not. (The latter is fixed every hour or so, but you might hit corrupted data on occasion.) These are limitations associated with fetching data automatically, that likely could be overcome, but we never quite had the time to figure it out ourselves. In short, please verify all data before loading it into your own database.
No credit required. We’d appreciate it if you mentioned us somewhere or other… but it seems silly to require it. Just don’t use this power for evil, and we’re good to go :) Also, by using this data, you agree not to hold OpenNeo or anyone associated with it responsible for anything that goes wrong. Never hurts to mention that. The data is provided as-is, with absolutely no guarantee… but it’s still provided, which is something!
(You’ll note that the site terms of service says that you can’t access the site automatically in ways that aren’t intended, to prevent site overload. This announcement therefore overrides that condition for these two points of access. However, we still ask that you not fire billions of requests our way every second, for obvious reasons—we’d really rather not have the site going down every other minute. If it becomes an issue, we’ll temporarily ban the IP, and you can contact us for more information… but that probably won’t happen, anyway. Thanks!)
Thanks for all you’ve done, Neopia, and here’s hoping we can use this to give back!
