Errors

Permission denied

When a restricted action is requestted without sufficient priveleges, the servlet will reply with:

{
error : 
 {
    type : "PERMISSION_DENIED",
    message : "You are not authorized to perform this operation"  
 }
}

The HTTP status will be set to 401

Missing resource

This error is returned when an ID is given but the resource (study, variable etc) isn’t found.

{
 error : {
    type: MISSING_RESOURCE,
    message : "text"
 }
}

This response will have the HTTP status set to 404.

Bad request

If the server side cannot interpret the request properly, this error is returned. This covers for instance requests that miss mandatory input variables such as at least one break variable in tabulation or no dependent variable in regresison.

{
 error : {
    type: "BAD_REQUEST",
    message : "text"
 }
}

This response will have the HTTP status set to 400.

Unexpected error

If something unexpected happens on the server (something that is not covered by the other errors here) this error is returned.

{
 error : {
    type: "UNEXPECTED ERROR",
    message : "text"
 }
}

This response will have the HTTP status set to 500.