Check-out athlete from target lane

POST /rest/biathlon/target/athlete/check-out

Checks out the athlete from the shooting lane when they have finished shooting. The check-out also occurs automatically when the target is reset. Two special cases to note:

  • If the athlete has not scored any hits on the target, an automatic check-out is not possible as there is no detectable state change when resetting. Only after a check-out can the target be reassigned with a new check-in.
  • The second special case is when, due to a defect or external hit, the target must be reset before the shooter has finished their shooting. The shooter must then be checked in again on the lane.

Query parameters

  • lane integer Required

    Lane Specification:

    • Represents the specific shooting lane assigned to an athlete in the competition.
    • Used for both prone (lying) and standing shooting positions.
    • Each lane is uniquely identified and corresponds to the particular prone and standing targets.
  • athlete-id string Required

    Athlete Identifier:

    • Represents the unique number (ID) assigned to each athlete in the competition.
    • Corresponds to the "Startnummer" (bib number) displayed on the athlete's uniform.
    • Team bib numbers can be provided with the subnumber of the current team athlete.

Responses

  • 200 application/json

    Athlete checked out successfully

    Hide response attributes Show response attributes object
    • success boolean
    • message string
    • lane integer
    • athlete_id string
  • 400 application/json

    Missing required field or missing required parameters

    Hide response attributes Show response attributes object
    • success boolean
    • message string
POST /rest/biathlon/target/athlete/check-out 
curl \
 --request POST 'http://api.example.com/rest/biathlon/target/athlete/check-out?lane=42&athlete-id=123'
Response examples (200) 
{
  "success": true,
  "message": "Athlete checked out successfully",
  "lane": 2,
  "athlete_id": 123
}
Response examples (400) 
{
  "success": false,
  "message": "'Invalid parameters' or 'Missing required parameters'"
}