This section explains the following REST operations regarding the collection which has been secured with OAuth 2.0.
The following terms explains the meaning of the parameters passed with the below REST URIs
Parameter | Explanation |
---|---|
collection path | Path of the resource |
OAuth access token | Authorized access token per user for an hour by default |
When a user adds a collection to the registry, the user has to specify the Media-Type of the collection in the request (as a Header). The Media-Type for the collection is "application/atomcoll+xml". If the user specifies a different content-type for the collection, the resource to be added won't be considered as a collection.
Get the Content of a Collection
Attributes | Values |
---|---|
HTTP Method | GET |
Request URI | /artifact{ collection path } |
HTTP Request Header | Authorization: Bearer { OAuth access token } |
Response | HTTP 200 OK |
Description | Retrieves the content of the requested collection |
Add a Collection
Attributes | values |
---|---|
HTTP Method | PUT |
Request URI | /artifact{ complete path of the collection to be added } |
HTTP Request Header | Authorization: Bearer { OAuth access token } |
HTTP Request Header | Media-Type: application/atomcoll+xml |
Response | HTTP 204 No Content |
Description | It adds the specified collection |
Delete a Collection
Attributes | values |
---|---|
HTTP Method | DELETE |
Request URI | /artifact{ collection path } |
HTTP Request Header | Authorization: Bearer { OAuth access token } |
Response | HTTP 204 No Content |
Description | It deletes the requested collection if it exists. |