This is an old revision of the document!


/api/scoresheets/ID/score/ID/points

HEAD, GET

A request with the GET verb returns the score's points as JSON encoded string (or null, if there are no points set). Note that 0 points is returned as “0” as it is a perfectly valid number of points.

Syntax

GET /api/scoresheets/123/score/321/points
Host: apply.example.edu
Authorization: DREAM apikey="..."

Response headers

Content-Type: application/json
Content-Length: 1234

Response codes

200 OK The value is returned successfully
404 Not Found Scoresheet does not have this score

Response example

"3.14"

PUT

Set the points of a scoresheet score to a particular value. This will still run all validation checks and will not permit illegal point values to be entered that fall out of the accepted range as set in the scoresheet settings. If setting mapped values (for example if 5 = Excellent), the numeric value must be sent.

Syntax

PUT /api/scoresheets/123/scores/321/points
Host: apply.example.edu
Authorization: DREAM apikey="..."

Raw request body

Write the JSON encoded points into the request body. Note that it is a JSON string, so it has to be enclosed in double quotes. You can set 0 points (which is perfectly valid) as “0” or “0.0” or “0.00”, as you please. But you cannot clear the points using this method. Please use the DELETE verb for that.

"3.14"

Response headers

Content-Type: text/plain
Content-Length: 0

Response codes

204 No Content The points were successfully saved
404 Not Found Scoresheet does not have this score
400 Bad Request The points value did not pass the validation tests or is not a JSON string with double quotes.

DELETE

Delete the points of a scoresheet score, resetting it to “not scored” which is distinct from a perfectly valid score of 0 points.

Syntax

DELETE /api/scoresheets/123/scores/321/points
Host: apply.example.edu
Authorization: DREAM apikey="..."

Response headers

Content-Type: text/plain
Content-Length: 0

Response codes

204 No Content The points were successfully cleared
404 Not Found Scoresheet does not have this score