View source for API Upload Judging Score

== Upload Judging Score ==
Records project assessment scores for a judging round. Optionally clears existing scores for that round first.

=== Authentication ===
All data API calls are <code>POST</code> (unless noted) with JSON body:

{| class="wikitable"
|-
! Field !! Required !! Description
|-
| <code>ApiKey</code> || Yes || Private API key for your site.
|-
| <code>FairId</code> || Yes || Fair GUID from the site URL (<code>f</code> query parameter).
|-
| <code>Body</code> || Depends || Request payload. Use <code>{}</code> when no body fields are needed.
|}


Calls must be run '''server-side''' — do not expose your API key in a browser.

=== Response envelope ===
Most endpoints return:

<pre>
{
  Success: true,
  Message: null,   // error text when Success is false
  Body: { ... }    // endpoint-specific payload
}
</pre>


=== Request ===
<syntaxhighlight lang="JavaScript" line>
fetch('/api/data/JudgingScores', {
    method:'POST',
    headers:{'Content-Type': 'application/json'},
    body: JSON.stringify({
            ApiKey:'<Private key>',
            FairId: '9df61f13-474b-442f-ac1f-edca7348ef71', // value of f in your URL
            Body: {
				RoundId: 2,
				ClearOldScores: true,
				Assignments: [
					{
						ProjectKey: "32161f13-474b-442f-ac1f-edca7348e000",
						JudgeId: "judge-public-guid",
						Score: 95.5,
						Notes: "Strong methodology"
					}
				]
			}
        })
})
.then(response => response.json())
.then(data=>{console.log('Success: ',data);})
.catch((error)=>{console.log('Error: ', error);});
</syntaxhighlight>

=== Response ===
On success:

<pre>
{
  Success: true,
  Message: "Assignment count: 1\n...",  // processing log; unknown judge/project lines
  Body: null
}
</pre>


=== Field notes ===
* Empty scores returns: <code>No scores to set</code>.
* Notes default to <code>Loaded by API</code> when omitted.
* For reading scores back for a round, POST to <code>/api/data/JudgingScoresForRound</code> with <code>Body.RoundId</code> (see [[API Judging Scores]]).


=== Related APIs ===
* [[API Judging Scores]]
* [[API Set Judging Assignments]]
* [[API Get Judges]] / [[API Get Projects]] / [[API Get Info]]


<br/><br/>
[[Category: API]]