Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

Note

The following terms explain the meaning of the parameters passed with the following REST URIs

ParameterExplanation
pathPath of the resource
OAuth access tokenAuthorized access token per user for an hour by default
namename Name of the property on the given resource

array of values

Array of values for the property eg: [ {"name":"val1Name","val2"value":["Ajith","val3",......Eranda"]} ]
startstart Start page number
sizenumber Number of tags to be fetched
userusername Username of the user
Note

The {start page} and {number of records} parameters can take any value greater than or equal to 0. The {start page} and {number of records} begins with 1. If both of them are 0, then all the properties are retrieved.

...

AttributesValues

HTTP Method                

GET
Request URI/properties?path={ resource path }&start={ start page }&size={ number of records }&user={ user name }
HTTP Request HeaderAuthorization: Bearer { OAuth access token }
DescriptionThis retrieves all the properties posted on the specific resource with a specified start page and size.
ResponseHTTP 200 OK
Response TypeJSONapplication/json

Get a Property of a Given Resource

AttributesValues

HTTP Method                

GET
Request URI/property?path={ resource path }&name={ property name }&user={ user name }
HTTP Request HeaderAuthorization: Bearer { OAuth access token }
DescriptionThis retrieves the specific property associated with the given property name.
ResponseHTTP 200 OK
Response TypeJSONapplication/json

Add Properties to a Resource

Type
AttributesValues

HTTP Method                

POST
Request URI/propertyproperties?path={ resource path }&user={ user name }
HTTP Request HeaderHeaders

Authorization: Bearer { OAuth access token }

Content-Type: application/json

Payload[ {"name":"<property name>propperty1","value":[<array of values>"value1","value2"]} ]     
DescriptionAdd the array of properties for the given resource
ResponseJSON

Update Properties of a Given Resource

AttributesValues

HTTP Method                

PUT
Request URI/property?path={ resource path }&user={ user name }
HTTP Request Header

Authorization: Bearer { OAuth access token }

Content-Type: application/json

Payload[ {"name":"<property name>","value":[<array of updated values>] }]
DescriptionUpdate the respective properties with the newly passed array of properties
Response TypeJSON
204 No Content
Response Typeapplication/json


Delete a Property of a Given Resource

AttributesValues

HTTP Method                

DELETE
Request URI/property?path={ resource path }&name={property name}&user={ user name}
HTTP Request HeaderAuthorization: Bearer { OAuth access token }
DescriptionDeletes the specified property from the given resource
ResponseHTTP 204 No Content
Response TypeJSONapplication/json