[Opensim-dev] Asset Server Rest Interface Roundup

[Bowman, Mic]

do you expect to support enumeration of assets? will import/export of
multiple formats be embedded in the mime encoding of the incoming asset
creation request?

--mic


-----Original Message-----
From: opensim-dev-bounces at lists.berlios.de
[mailto:opensim-dev-bounces at lists.berlios.de] On Behalf Of Sean Dague
Sent: Monday, November 05, 2007 2:26 PM
To: opensim-dev
Subject: [Opensim-dev] Asset Server Rest Interface Roundup

After some lively weekend discussion, I think this is where we ended up:

Interface

The ASSET server will support REST over HTTP/HTTPS.  MW's work over the
weekend got POST requests working on all platforms, so any concerns
there should be allayed (at least for now)

URI & Methods

The URI for an ASSET will be: http://assetserver/assets/assetid/UUID (no
dashes).  ASSETS will support 3 Methods.

 * GET - returning an application/xml response representing an asset +
         status code as HTTP header
 * POST - creation of an asset, returning a status code only
 * DELETE - deletion of an asset, returning a status code only

PUT will not be supported as updating of existing assets won't be
supported for concurency reasons.

Status Codes

We'll use at least the following status codes:
 
 * 200 - GET / DELETE - Success
 * 201 - POST - Created
 * 400 - POST - Bad Request (UUID of URL doesn't match UUID of post, or
                UUID collision)
 * 401 - Unauthorized
 * 404 - Not Found

Authorization

Open Question?  (We never really got this out on the table)

Data Format for GET / POST

This is a serialized xml Asset Object today.  We won't standardize this
until a ways in the future when we feel that it is unlikely to change.
As such, there may need to be version sync between Asset Server and
Asset Clients when changes are made to the Asset Object structure.


Hopefully this fully expresses what came out on the list.  If anyone
feels I missed something, please just respond to this post.

      -Sean
 
-- 
__________________________________________________________________

Sean Dague                                       Mid-Hudson Valley
sean at dague dot net                            Linux Users Group
http://dague.net                                 http://mhvlug.org

There is no silver bullet.  Plus, werewolves make better neighbors
than zombies, and they tend to keep the vampire population down.
__________________________________________________________________