Organisation
From ToxBank API Wiki
(Difference between revisions)
m |
m |
||
| Line 5: | Line 5: | ||
A [[Protocol]] is always associated with an organisation,and the protocol representation includes a link to an Organisation. | A [[Protocol]] is always associated with an organisation,and the protocol representation includes a link to an Organisation. | ||
| − | + | = REST Operations = | |
| − | + | == GET: Retrieve all organisations == | |
{{REST Operations | {{REST Operations | ||
|REST_op_description=Retrieves available organisations | |REST_op_description=Retrieves available organisations | ||
| Line 30: | Line 30: | ||
http://toxbanktest1.opentox.org:8080/toxbank/organisation?page=0&pagesize=3 | http://toxbanktest1.opentox.org:8080/toxbank/organisation?page=0&pagesize=3 | ||
| − | + | == GET: Retrieve an organisation == | |
{{REST Operations | {{REST Operations | ||
|REST_op_description=Retrieves an organisation | |REST_op_description=Retrieves an organisation | ||
| Line 47: | Line 47: | ||
curl -X GET -H 'Accept:text/uri-list' -H 'subjectid:TOKEN' http://toxbanktest1.opentox.org:8080/toxbank/organisation/G1 | curl -X GET -H 'Accept:text/uri-list' -H 'subjectid:TOKEN' http://toxbanktest1.opentox.org:8080/toxbank/organisation/G1 | ||
| − | + | ==POST: Create a new organisation == | |
{{REST Operations | {{REST Operations | ||
|REST_op_description=Creates an organisation | |REST_op_description=Creates an organisation | ||
| Line 65: | Line 65: | ||
-d 'title=MANDATORY_VALUE' -d 'ldapgroup=OPTIONAL_VALUE' http://toxbanktest1.opentox.org:8080/toxbank/organisation | -d 'title=MANDATORY_VALUE' -d 'ldapgroup=OPTIONAL_VALUE' http://toxbanktest1.opentox.org:8080/toxbank/organisation | ||
| − | + | == PUT: Update an organisation metadata == | |
{{REST Operations | {{REST Operations | ||
|REST_op_description=Updates the organisation metadata | |REST_op_description=Updates the organisation metadata | ||
| Line 83: | Line 83: | ||
-d 'title=MANDATORY_VALUE' -d 'ldapgroup=OPTIONAL_VALUE' http://toxbanktest1.opentox.org:8080/toxbank/organisation/G3 | -d 'title=MANDATORY_VALUE' -d 'ldapgroup=OPTIONAL_VALUE' http://toxbanktest1.opentox.org:8080/toxbank/organisation/G3 | ||
| − | + | == DELETE: Remove an organisation == | |
{{REST Operations | {{REST Operations | ||
|REST_op_description=Removes an existing organisation | |REST_op_description=Removes an existing organisation | ||
| Line 100: | Line 100: | ||
curl -X DELETE -H 'subjectid:TOKEN' http://toxbanktest1.opentox.org:8080/toxbank/organisation/G3 | curl -X DELETE -H 'subjectid:TOKEN' http://toxbanktest1.opentox.org:8080/toxbank/organisation/G3 | ||
| − | + | = RDF representation = | |
[http://jenkins.toxbank.net/job/toxbank-api-beans/ws/target/test-classes/net.toxbank.client.resource.Organisation.30.n3 RDF N3] | [http://jenkins.toxbank.net/job/toxbank-api-beans/ws/target/test-classes/net.toxbank.client.resource.Organisation.30.n3 RDF N3] | ||
This RDF representation is automatically generated by the latesr version of the [https://github.com/ToxBank/toxbank-api-beans Toxbank Java client library] | This RDF representation is automatically generated by the latesr version of the [https://github.com/ToxBank/toxbank-api-beans Toxbank Java client library] | ||
Revision as of 12:36, 14 December 2011
| Organisation |
|---|
An organisation is a REST resource,representing SEURAT cluster partners, or external organisations. An organisation is identified by its URI, has a name and may be assigned an LDAP group. The LDAP group should be one of the existing ToxBank LDAP groups and accessible via ToxBank OpenAM. External organisations may or may not be assigned an LDAP group.
A Protocol is always associated with an organisation,and the protocol representation includes a link to an Organisation.
Contents |
REST Operations
GET: Retrieve all organisations
| Description | Retrieves available organisations |
|---|---|
| Resource | Organisation |
| Method | GET |
| URI | /organisation |
| Parameters | none, or ?search=name or paging parameters: page, pagesize |
| Header Parameters | subjectid:SECURITY-TOKEN |
| Media Type (input) | none |
| Results | The organisation representation in supported media type |
| Media Type (output) | application/rdf+xml;text/n3;text/uri-list |
| Status code | 200,400,401,402,403 |
Example: http://toxbanktest1.opentox.org:8080/toxbank/organisation
curl -X GET -H 'Accept:text/uri-list' -H 'subjectid:TOKEN' http://toxbanktest1.opentox.org:8080/toxbank/organisation
curl -X GET -H 'Accept:application/rdf+xml' -H 'subjectid:TOKEN' \
http://toxbanktest1.opentox.org:8080/toxbank/organisation?search=Douglas+Connect
curl -X GET -H 'Accept:text/uri-list' -H 'subjectid:TOKEN' \
http://toxbanktest1.opentox.org:8080/toxbank/organisation?page=0&pagesize=3
GET: Retrieve an organisation
| Description | Retrieves an organisation |
|---|---|
| Resource | Organisation |
| Method | GET |
| URI | /organisation/{id} |
| Parameters | none |
| Header Parameters | subjectid:SECURITY-TOKEN |
| Media Type (input) | none |
| Results | The organisation representation in supported media type |
| Media Type (output) | application/rdf+xml;text/n3;text/uri-list |
| Status code | 200,400,401,402,403 |
Example: http://toxbanktest1.opentox.org:8080/toxbank/organisation/G1
curl -X GET -H 'Accept:text/uri-list' -H 'subjectid:TOKEN' http://toxbanktest1.opentox.org:8080/toxbank/organisation/G1
POST: Create a new organisation
| Description | Creates an organisation |
|---|---|
| Resource | Organisation |
| Method | POST |
| URI | /organisation |
| Parameters | Any combination of name,ldapgroup |
| Header Parameters | subjectid:SECURITY-TOKEN |
| Media Type (input) | application/x-www-form-urlencoded |
| Results | Task representation in supported MIME formats |
| Media Type (output) | application/rdf+xml;text/n3;text/uri-list |
| Status code | 200,202,400,401,402,403,500 |
Example: http://toxbanktest1.opentox.org:8080/toxbank/organisation
curl -X POST -H 'subjectid:TOKEN' -H 'Content-Type:application/x-www-form-urlencoded' \
-d 'title=MANDATORY_VALUE' -d 'ldapgroup=OPTIONAL_VALUE' http://toxbanktest1.opentox.org:8080/toxbank/organisation
PUT: Update an organisation metadata
| Description | Updates the organisation metadata |
|---|---|
| Resource | [[]] |
| Method | PUT |
| URI | /organisation/{id} |
| Parameters | Any combination of name,ldapgroup |
| Header Parameters | subjectid:SECURITY-TOKEN |
| Media Type (input) | application/x-www-form-urlencoded |
| Results | Task representation in supported MIME formats |
| Media Type (output) | application/rdf+xml;text/n3;text/uri-list |
| Status code | 200,202,400,401,402,403,500 |
Example:
curl -X PUT -H 'subjectid:TOKEN' -H 'Content-Type:application/x-www-form-urlencoded' \
-d 'title=MANDATORY_VALUE' -d 'ldapgroup=OPTIONAL_VALUE' http://toxbanktest1.opentox.org:8080/toxbank/organisation/G3
DELETE: Remove an organisation
| Description | Removes an existing organisation |
|---|---|
| Resource | [[]] |
| Method | DELETE |
| URI | /organisation/{id} |
| Parameters | none |
| Header Parameters | subjectid:SECURITY-TOKEN |
| Media Type (input) | none |
| Results | Task representation in supported MIME formats |
| Media Type (output) | application/rdf+xml;text/n3;text/uri-list |
| Status code | 200,202,400,401,402,403,500 |
Example:
curl -X DELETE -H 'subjectid:TOKEN' http://toxbanktest1.opentox.org:8080/toxbank/organisation/G3
RDF representation
This RDF representation is automatically generated by the latesr version of the Toxbank Java client library
Facts about OrganisationRDF feed
| Acts on | |
| Has output media type | application/rdf+xml;text/n3;text/uri-list + |
| Has status code | 200,202,400,401,402,403,500 + |
