Spaces Resource

Useful Information

Spaces Resources are identified by the following resource name: /spaces/{spaceName} where "spaceName" is the name of the space. The collection of Spaces is denoted by /spaces/

Handy Hint

The Resources API examples should map to the use cases presented in previous sections.

List Spaces

HTTP Component	HTTP Component Value	Description
Method	GET
Body	None
Encoding	None
Accept	text/html	Currently we only support returning via HTML. Future versions could support Atom or RSS
Response Code	200	Success
	403	Unauthorized
	401	Authentication

Example HTTP Request

GET /spaces/ HTTP/1.1
Host: registry.rutgers.edu

Example HTTP Response

HTTP/1.1 200 OK

<ul>
<li><a href="http://registry.rutgers.edu/spaces/IdM">IdM</a></li>
<li><a href="http://registry.rutgers.edu/spaces/ESS">ESS</a></li>
<li><a href="http://registry.rutgers.edu/spaces/MySpace">MySpace</a></li>
</ul>

Create a Space

HTTP Component	HTTP Component Value	Description
Method	PUT
Body	Set of owner Ids
Encoding	www-url-form-encoded	Currently we accept www-url-form-encoded. Future versions could accept XML, RSS, Atom, etc.
Response Code	201	Created
	403	Unauthorized
	400	Bad Request
	???	Already Exists
	401	Authentication

Example HTTP Request

PUT /spaces/IdM HTTP/1.1
Host: registry.rutgers.edu

owner_id=567&owner_id=568&owner_id=123

Example HTTP Response

HTTP/1.1 201 Created

Delete a Space

HTTP Component	HTTP Component Value	Description
Method	DELETE
Body	None
Response Code	200	Success
	403	Unauthorized
	404	Space never existed
	401	Authentication

Example HTTP Request

DELETE /spaces/IdM HTTP/1.1
Host: registry.rutgers.edu

Example HTTP Response

HTTP/1.1 200 OK

Space "IdM" was successfully deleted.

Rename a Space

HTTP Component	HTTP Component Value	Description
Method	PUT
Body	the new space name
Encoding	www-url-form-encoded	Currently we accept www-url-form-encoded. Future versions could accept XML, RSS, Atom, etc.
Response Code	204	Success
	403	Unauthorized
	404	Not found
	400	Bad User Request
	401	Authentication

Example HTTP Request

PUT /spaces/IdM HTTP/1.1
Host: registry.rutgers.edu

newSpaceName=IdMs

Example HTTP Response

HTTP/1.1 204 No Content
Location: http://registry.rutgers.edu/spaces/IdMs