Resource Study.Roster
Method GET
Purpose Obtain a list of existing roleholders for a study
Client sends … RequestGET roster-URI
HeaderHost: host
HeaderDate: date
HeaderAuthorization: yosokumo user-identifier:request-digest
Header (optional)Accept: content-type(s)
Header (optional)Accept-Encoding: content-encoding(s)
Server returns … SuccessCode200 OK
HeaderDate: date
HeaderContent-Type: content-type
Header (conditional)Content-Encoding: content-encoding
Header (conditional)Content-Length: content-length
HeaderContent-MD5: content-digest
Entity<roster document>
Authorization header malformedCode400 Bad Request
Authorization header missingCode401 Unauthorized
HeaderWWW-Authenticate: yosokumo user:digest
• Requesting user not recognized
• Request digest incorrect
• Requesting user lacks GET roster permission for this study
Code 403 Forbidden
Requested URI not recognizedCode404 Not Found
• No supported data interchange format listed in Accept header
• No supported encoding format listed in Accept-Encoding header
Code 406 Not Acceptable