h1. Get all memberships in the system
h2. Syntax
Memberships in the system can be accessed using http GET method through below url:
{code}http://localhost:8810/rest/memberships{code}
The response is of mime type _application/xml_ and the content is XML representation of all memberships in the system.
h2. Security
You will need to use http BASIC authentication to login as authorized QuickBuild user if the anonymous does not have adminstrative right.
h2. Demo
Below [curl|http://curl.haxx.se/] command demonstrates how to get all memberships:
{code}curl -u admin:admin http://localhost:8810/rest/memberships{code}
h1. Access membership by id
h2. Syntax
Membership can be accessed by id using http GET method through below url:
{code}http://localhost:8810/rest/memberships/<membership id>{code}
The response is of mime type _application/xml_ and the content is XML representation of the membership.
h2. Security
You will need to use http BASIC authentication to login as authorized QuickBuild user if the anonymous does not have adminstrative right.
h2. Demo
Below [curl|http://curl.haxx.se/] command demonstrates how to get membership of id _1_:
{code}curl -u admin:admin http://localhost:8810/rest/memberships/1{code}
h1. Access memberships of a particular user
h2. Syntax
Memberships of particular user can be accessed using http GET method through below url:
{code}http://localhost:8810/rest/memberships?user_id=<user id>{code}
The response is of mime type _application/xml_ and the content is XML representation of all memberships of specified user.
h2. Security
You will need to use http BASIC authentication to login as authorized QuickBuild user if the anonymous does not have adminstrative right.
h2. Demo
Below [curl|http://curl.haxx.se/] command demonstrates how to get memberships of user with id _2_:
{code}curl -u admin:admin http://localhost:8810/rest/memberships?user_id=2{code}
h1. Access memberships of a particular group
h2. Syntax
Memberships of particular group can be accessed using http GET method through below url:
{code}http://localhost:8810/rest/memberships?group_id=<group id>{code}
The response is of mime type _application/xml_ and the content is XML representation of all memberships of specified group.
h2. Security
You will need to use http BASIC authentication to login as authorized QuickBuild user if the anonymous does not have adminstrative right.
h2. Demo
Below [curl|http://curl.haxx.se/] command demonstrates how to get memberships of group with id _1_:
{code}curl -u admin:admin http://localhost:8810/rest/memberships?group_id=1{code}
h1. Update membership
h2. Syntax
Membership can be updated by posting xml representation of the membership to below url:
{code}http://localhost:8810/rest/memberships{code}
Normally you do not need to create the XML from scratch: you may retrieve XML representation of the membership using http GET method, modify certain parts of the XML and post back to above url.
The response is of mime type _text/plain_ and the content is string representation of the membership id being updated.
h2. Security
You will need to use http BASIC authentication to login as administrator if the anonymous does not have administrative right.
h2. Demo
We will use [curl|http://curl.haxx.se/] to demonstrate how to move user _robin_ from _developer_ group to _tester_ group:
# Assume id of user _robin_ is _2_, id of group _developer_ is _1_, and id of group _tester_ is _2_. Ids of these entities can be accessed using [id service|retrieve object identifier].
# Run below command to get memberships of user _robin_:
{code}curl -u admin:admin http://localhost:8810/rest/memberships?user_id=2{code}
# Analyze response of above command to find out the membership with group id _1_. Save xml snippet of found membership to a temp file, say _tempfile.xml_.
# Modify _tempfile.xml_ and change the _group_ element to use value of _2_.
# Post content of _tempfile.xml_ back to QuickBuild using below command:
{code}curl -X POST -u admin:admin -d@tempfile.xml http://localhost:8810/rest/memberships{code}
h1. Create membership
h2. Syntax
Membership can be created by posting XML representation of the membership to below url:
{code}http://localhost:8810/rest/memberships{code}
A sample membership XML representation is like below:
{code}
<com.pmease.quickbuild.model.Membership>
<!-- id of associated user of this membership. -->
<user>2</user>
<!-- id of associated group of this membership. -->
<group>1</group>
</com.pmease.quickbuild.model.Membership>
{code}
The response is of mime type _text/plain_ and the content is string representation of the newly created membership id.
h2. Security
You will need to use http BASIC authentication to login as administrator if the anonymous does not have administrative right.
h2. Demo
We will use [curl|http://curl.haxx.se/] to demonstrate how to add user _robin_ (assume id is _2_) to group _tester_ (assume the id is _3_).
# Save below content into file _tempfile.xml_:
{code}
<com.pmease.quickbuild.model.Membership>
<user>2</user>
<group>3</group>
</com.pmease.quickbuild.model.Membership>
{code}
# Post content of _tempfile.xml_ to QuickBuild using below command:
{code}curl -X POST -u admin:admin -d@tempfile.xml http://localhost:8810/rest/memberships{code}
h1. Delete membership
h2. Syntax
Membership can be deleted using http DELETE method through below url:
{code}http://localhost:8810/rest/memberships/<membership id>{code}
Here _<membership id>_ stands for id of the membership to be deleted.
h2. Security
You will need to use http BASIC authentication to login as administrator if the anonymous does not have administrative right.
h2. Demo
Below [curl|http://curl.haxx.se/] command demonstrates how to remove user _robin_ (assume id is _2_) from group _tester_ (assume the id is _3_).
# Get memberships of user _robin_ with below command:
{code}curl -u admin:admin http://localhost:8810/rest/memberships?user_id=2{code}
# Analyze response of above command to find out id of the membership associated with group id _3_, assume id of the found membership is _100_.
# Delete the found membership with below command:
{code}curl -X DELETE -u admin:admin http://localhost:8810/rest/memberships/100{code}
h2. Syntax
Memberships in the system can be accessed using http GET method through below url:
{code}http://localhost:8810/rest/memberships{code}
The response is of mime type _application/xml_ and the content is XML representation of all memberships in the system.
h2. Security
You will need to use http BASIC authentication to login as authorized QuickBuild user if the anonymous does not have adminstrative right.
h2. Demo
Below [curl|http://curl.haxx.se/] command demonstrates how to get all memberships:
{code}curl -u admin:admin http://localhost:8810/rest/memberships{code}
h1. Access membership by id
h2. Syntax
Membership can be accessed by id using http GET method through below url:
{code}http://localhost:8810/rest/memberships/<membership id>{code}
The response is of mime type _application/xml_ and the content is XML representation of the membership.
h2. Security
You will need to use http BASIC authentication to login as authorized QuickBuild user if the anonymous does not have adminstrative right.
h2. Demo
Below [curl|http://curl.haxx.se/] command demonstrates how to get membership of id _1_:
{code}curl -u admin:admin http://localhost:8810/rest/memberships/1{code}
h1. Access memberships of a particular user
h2. Syntax
Memberships of particular user can be accessed using http GET method through below url:
{code}http://localhost:8810/rest/memberships?user_id=<user id>{code}
The response is of mime type _application/xml_ and the content is XML representation of all memberships of specified user.
h2. Security
You will need to use http BASIC authentication to login as authorized QuickBuild user if the anonymous does not have adminstrative right.
h2. Demo
Below [curl|http://curl.haxx.se/] command demonstrates how to get memberships of user with id _2_:
{code}curl -u admin:admin http://localhost:8810/rest/memberships?user_id=2{code}
h1. Access memberships of a particular group
h2. Syntax
Memberships of particular group can be accessed using http GET method through below url:
{code}http://localhost:8810/rest/memberships?group_id=<group id>{code}
The response is of mime type _application/xml_ and the content is XML representation of all memberships of specified group.
h2. Security
You will need to use http BASIC authentication to login as authorized QuickBuild user if the anonymous does not have adminstrative right.
h2. Demo
Below [curl|http://curl.haxx.se/] command demonstrates how to get memberships of group with id _1_:
{code}curl -u admin:admin http://localhost:8810/rest/memberships?group_id=1{code}
h1. Update membership
h2. Syntax
Membership can be updated by posting xml representation of the membership to below url:
{code}http://localhost:8810/rest/memberships{code}
Normally you do not need to create the XML from scratch: you may retrieve XML representation of the membership using http GET method, modify certain parts of the XML and post back to above url.
The response is of mime type _text/plain_ and the content is string representation of the membership id being updated.
h2. Security
You will need to use http BASIC authentication to login as administrator if the anonymous does not have administrative right.
h2. Demo
We will use [curl|http://curl.haxx.se/] to demonstrate how to move user _robin_ from _developer_ group to _tester_ group:
# Assume id of user _robin_ is _2_, id of group _developer_ is _1_, and id of group _tester_ is _2_. Ids of these entities can be accessed using [id service|retrieve object identifier].
# Run below command to get memberships of user _robin_:
{code}curl -u admin:admin http://localhost:8810/rest/memberships?user_id=2{code}
# Analyze response of above command to find out the membership with group id _1_. Save xml snippet of found membership to a temp file, say _tempfile.xml_.
# Modify _tempfile.xml_ and change the _group_ element to use value of _2_.
# Post content of _tempfile.xml_ back to QuickBuild using below command:
{code}curl -X POST -u admin:admin -d@tempfile.xml http://localhost:8810/rest/memberships{code}
h1. Create membership
h2. Syntax
Membership can be created by posting XML representation of the membership to below url:
{code}http://localhost:8810/rest/memberships{code}
A sample membership XML representation is like below:
{code}
<com.pmease.quickbuild.model.Membership>
<!-- id of associated user of this membership. -->
<user>2</user>
<!-- id of associated group of this membership. -->
<group>1</group>
</com.pmease.quickbuild.model.Membership>
{code}
The response is of mime type _text/plain_ and the content is string representation of the newly created membership id.
h2. Security
You will need to use http BASIC authentication to login as administrator if the anonymous does not have administrative right.
h2. Demo
We will use [curl|http://curl.haxx.se/] to demonstrate how to add user _robin_ (assume id is _2_) to group _tester_ (assume the id is _3_).
# Save below content into file _tempfile.xml_:
{code}
<com.pmease.quickbuild.model.Membership>
<user>2</user>
<group>3</group>
</com.pmease.quickbuild.model.Membership>
{code}
# Post content of _tempfile.xml_ to QuickBuild using below command:
{code}curl -X POST -u admin:admin -d@tempfile.xml http://localhost:8810/rest/memberships{code}
h1. Delete membership
h2. Syntax
Membership can be deleted using http DELETE method through below url:
{code}http://localhost:8810/rest/memberships/<membership id>{code}
Here _<membership id>_ stands for id of the membership to be deleted.
h2. Security
You will need to use http BASIC authentication to login as administrator if the anonymous does not have administrative right.
h2. Demo
Below [curl|http://curl.haxx.se/] command demonstrates how to remove user _robin_ (assume id is _2_) from group _tester_ (assume the id is _3_).
# Get memberships of user _robin_ with below command:
{code}curl -u admin:admin http://localhost:8810/rest/memberships?user_id=2{code}
# Analyze response of above command to find out id of the membership associated with group id _3_, assume id of the found membership is _100_.
# Delete the found membership with below command:
{code}curl -X DELETE -u admin:admin http://localhost:8810/rest/memberships/100{code}