Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: update to voot2

...

Code Block
languagexml
titleExample
collapsetrue
Host: voot.surfconext.nl
GET /me/groups HTTP/1.1
 
Response

HTTP/1.1 200 OK
Content-Type: application/json

[ {
  "filteredid" : false"urn:collab:group:uniharderwijk.nl:cis",
  "itemsPerPagedisplayName" : 2,
  "sortedcis": true,
  "startIndexdescription" : 0null,
  "totalResultssourceID" : 2,
  "updatedSinceUniHarderwijk": false,
  "entrymembership" : [
    {
      "descriptionbasic" : "member"Private
law working group}
2014Q2"}, {
     "id" : "urn:collab:group:surfteams.nl:nl:surfnet:diensten:privat_law_2014Q2myexampleteam",
      "titledisplayName" : "Private law 2014Q2MyExampleTeam",
  
   "voot_membership_roledescription" : "admin"This team is an  },
    {
  example",
   "description": null,
      "id": "urn:collab:group:surfteams.nl:nl:surfnet:diensten:students2014",
      "title": "Students started in 2014",
 sourceID" : "SURFteams",
  "membership" : {
    "voot_membership_rolebasic" : "memberadmin"
  }
 }   ]
}

Get group information

Group information is taken from SURFconext Teams. This call will only return the group's information if the user is a member of this group.

...

Code Block
languagexml
titleExample of Get group information
collapsetrue
Host: voot.surfconext.nl
GET /me/groups/urn:collab:group:surfteams.nl:nl:surfnet:diensten:abc_helpdesk_administrators HTTP/1.1
 
Response
HTTP/1.1 200 OK
Content-Type: application/json
 
 
{
  "filteredid" : false,
  "itemsPerPage": 1 "urn:collab:group:surfteams.nl:nl:surfnet:diensten:abc_helpdesk_administrators",
  "sorteddisplayName": false,
  "startIndex": 0,
  "totalResults": 1,
  "updatedSince": false"ABC helpdesk administrators",
  "entry": [
    {
      "description"description" : "Administrators of the ABC helpdesk service.",
      "idsourceID" : "nl:surfnet:diensten:abc_helpdesk_administratorsSURFteams",
   
  "titlemembership" : "ABC helpdesk administrators",{
      "voot_membership_role""basic" : "admin"
    }
  ]
}

Request parameters

The calls can have three parameters:

  • startIndex
    offset as the start for giving back results.
  • count
    number of results to be returned.  
  • sortBy
    key for sorting groups. Possible values: id, title, description.
    note that the members of a group cannot be sorted
    sorting MUST be performed before startIndex and count
Code Block
languagexml
titleExample of Request parameters
/me/groups/urn:collab:group:surfteams.nl:nl:surfnet:diensten:privat_law_2014Q2?startIndex=3&count=2
/me/groups?sortBy=title

Response parameters

...


Errors

Handling failures of OAuth (Bearer) authentication are handled as described in [RFC 6750]. This will involve sending the WWW-Authenticate header if something is wrong, for example an invalid OAuth 2.0 access token will result in the following response:

...