Resource Service (or Catalog)
Method POST
Purpose Create a new study
Client sends … RequestPOST service-URI (or catalog-URI)
HeaderHost: host
HeaderDate: date
HeaderAuthorization: yosokumo user-identifier:request-digest
HeaderContent-Type: content-type
Header (optional)Content-Encoding: content-encoding
Header (optional)Content-Length: content-length
Header (optional)Content-MD5: content-digest
Header (optional)Accept: content-type(s)
Header (optional)Accept-Encoding: content-encoding(s)
Entity<study document (incomplete)>
Server returns … SuccessCode201 Created
HeaderDate: date
HeaderLocation: study-URI
Header (conditional)Content-Type: content-type
Header (conditional)Content-Encoding: content-encoding
Header (conditional)Content-Length: content-length
Header (conditional)Content-MD5: content-digest
Entity (conditional)<study document (complete)>
• Authorization header malformed
• Posted document not well-formed
• Posted document length does not match Content-Length header value
• Posted document digest does not match Content-MD5 header value
• Posted document not a study
Code 400 Bad Request
Authorization header missingCode401 Unauthorized
HeaderWWW-Authenticate: yosokumo user:digest
• Requesting user not recognized
• Request digest incorrect
• Requesting user lacks POST service permission
• Request references catalog not belonging to requesting user
Code 403 Forbidden
Requested URI not recognizedCode404 Not Found
User referenced in study document conflicts with catalog URICode409 Conflict
• Data interchange format of posted document not recognized
• Encoding of posted document not recognized
Code 415 Unsupported Format