Referee APP - Logs

Create Log

POST

/v1/referee/logs

💡

This request requires “PB-API-TOKEN” from the platforms or “PB-USER-TOKEN” from the authenticated user.

Request

{
  "payload": {
    "referee_uuid": "bc864930-22a9-4a63-b003-268b029342d0",
    "match_uuid": "0482eb4d-eb75-4f4d-bfb8-34970333b0db",
    "server_uuid": "bc864930-22a9-4a63-b003-268b029342d0",
    "receiver_uuid": "bc864930-22a9-4a63-b003-268b029342d0",
    "server": 2,
    "reverted_from_log_id": 2,
    "log_type": 2,
    "game_number": 2,
    "court_left_even_player_uuid": "",
    "court_left_odd_player_uuid": "",
    "court_right_even_player_uuid": "",
    "court_right_odd_player_uuid": "",
    "note": "",
    "groupUuid": "",
    "serverIndex": 1
  }
}

Response

{
  "result": {
    "id": "7",
    "referee_uuid": "bc864930-22a9-4a63-b003-268b029342d0",
    "match_uuid": "0482eb4d-eb75-4f4d-bfb8-34970333b0db",
    "server_uuid": "bc864930-22a9-4a63-b003-268b029342d0",
    "receiver_uuid": "bc864930-22a9-4a63-b003-268b029342d0",
    "server": 2,
    "date_created": "2023-01-03T13:43:35.744084781Z",
    "reverted_from_log_id": 2,
    "log_type": 2,
    "game_number": 2,
    "court_left_even_player_uuid": "",
    "court_left_odd_player_uuid": "",
    "court_right_even_player_uuid": "",
    "court_right_odd_player_uuid": "",
    "note": "",
    "groupUuid": "",
    "serverIndex": 1
  }
}

List Logs

GET

/v1/referee/logs?match_uuid={match_uuid}

💡

This request requires “PB-API-TOKEN” from the platforms or “PB-USER-TOKEN” from the authenticated user.

Query param	Description
page_size	Number value that represents number of returned results.
current_page	Number value that represents offset of returned results.
retrieve_all	Boolean value that when equal to true returns all results.
timestamp (retrieve logs only newer than timestamp)	Format to use: "2023-02-21T17:49:18.436850614Z" or "1739727918".

Response

{
  "total_records": "2",
  "results": [
    {
      "id": "5",
      "referee_uuid": "bc864930-22a9-4a63-b003-268b029342d0",
      "match_uuid": "0482eb4d-eb75-4f4d-bfb8-34970333b0db",
      "server_uuid": "bc864930-22a9-4a63-b003-268b029342d0",
      "receiver_uuid": "bc864930-22a9-4a63-b003-268b029342d0",
      "server": 2,
      "date_created": "2023-01-03T13:40:53.143511585Z",
      "reverted_from_log_id": 2,
      "log_type": 2,
      "game_number": 2,
      "court_left_even_player_uuid": "",
      "court_left_odd_player_uuid": "",
      "court_right_even_player_uuid": "",
      "court_right_odd_player_uuid": "",
      "note": "",
      "groupUuid": "",
      "serverIndex": 1
    },
    {
      "id": "6",
      "referee_uuid": "bc864930-22a9-4a63-b003-268b029342d0",
      "match_uuid": "0482eb4d-eb75-4f4d-bfb8-34970333b0db",
      "server_uuid": "bc864930-22a9-4a63-b003-268b029342d0",
      "receiver_uuid": "bc864930-22a9-4a63-b003-268b029342d0",
      "server": 2,
      "date_created": "2023-01-03T13:41:13.541968136Z",
      "reverted_from_log_id": 2,
      "log_type": 2,
      "game_number": 2,
      "court_left_even_player_uuid": "",
      "court_left_odd_player_uuid": "",
      "court_right_even_player_uuid": "",
      "court_right_odd_player_uuid": "",
      "note": "",
      "groupUuid": "",
      "serverIndex": 1
    }
  ]
}

List Single Log

GET

/v1/referee/logs/{id}

💡

This request requires “PB-API-TOKEN” from the platforms.

Response

{
  "id": "0f109bde-2bf6-4d9b-8736-ebec99d3f5fb",
  "referee_uuid": "1",
  "match_uuid": "bc864930-22a9-4a63-b003-268b029342d0",
  "date_created": "1669819214",
  "reverted_from_log_id": 2,
  "log_type": "COIN_TOSS",
  "log_data": "{\"uuid\":\"0f109bde-2bf6-4d9b-8736-ebec99d3f5fb\",\"refereeId\":\"1\",\"matchUuid\":\"bc864930-22a9-4a63-b003-268b029342d0\",\"dateCreatedTimestamp\":\"2022-11-30T14:40:14.835808619Z\",\"logType\":\"COIN_TOSS\",\"otherLog\":{\"playerUuid\":\"0\",\"teamUuid\":\"1\"},\"gameNumber\":\"1\",\"scorePlayerOneUuid\":\"dfa1d882-c748-43fc-8402-1426dcd5dc07\",\"scorePlayerTwoUuid\":\"dfa1d882-c748-43fc-8402-1426dcd5dc07\",\"scoreTeamOneUuid\":\"dfa1d882-c748-43fc-8402-1426dcd5dc07\",\"scoreTeamTwoUuid\":\"dfa1d882-c748-43fc-8402-1426dcd5dc07\",\"courtLeftEvenPlayerUuid\":\"dfa1d882-c748-43fc-8402-1426dcd5dc07\",\"courtLeftOddPlayerUuid\":\"dfa1d882-c748-43fc-8402-1426dcd5dc07\",\"courtRightEvenPlayerUuid\":\"dfa1d882-c748-43fc-8402-1426dcd5dc07\",\"courtRightOddPlayerUuid\":\"dfa1d882-c748-43fc-8402-1426dcd5dc07\"}",
  "game_number": "1",
  "point_log": {
    "time_started": "2022-11-30T14:23:50.314940773Z",
    "time_ended": "2022-11-30T14:23:50.314940773Z",
    "player_uuid": "dfa1d882-c748-43fc-8402-1426dcd5dc07",
    "team_uuid": "dfa1d882-c748-43fc-8402-1426dcd5dc07",
    "start_score": 1,
    "end_score": 2,
    "server_uuid": "dfa1d882-c748-43fc-8402-1426dcd5dc07",
    "reciver_uuid": "dfa1d882-c748-43fc-8402-1426dcd5dc07"
  }
}

Table Of Enums

Log Data

{
  BathroomBreakLog bathroom_brake_log = 101;
  MedicalTimeoutLog medical_timeout_log = 102;
  TimeoutLog timeout_log = 103;
  PointLog point_log = 104;
  ChallengeLog challenge_log = 105;
  CoinTossLog coin_toss_log = 106;
  GameOverLog game_over_log = 107;
  ForfeitLog forfeit_log = 108;
  MatchOverLog match_over_log = 109;
  MissedServeLog missed_serve_log = 110;
  PenaltyLog penalty_log = 111;
  PlayersOnCourtLog players_on_court_log = 112;
  PointReplayLog point_replay_log = 113;
  PointInProgressLog point_in_progress_log = 114;
  RetirementLog retirement_log = 115;
  ServeSelectionLog serve_selection_log = 116;
  SideOutLog side_out_log = 117;
  SwitchCourtSideLog switch_court_side_log = 118;
  TimeViolationLog time_violation_log = 119;
  WarmingUpLog warming_up_log = 120;
  WeatherDelayLog weather_delay_log = 121;
  SwitchServerLog switch_server_log = 122;
  CourtArrivalLog court_arrival_log = 123;
  StatisticLog statistic_log = 124;
  ChangeRefereeLog change_referee_log = 125;
  CheckConnectionLog check_connection_log = 126;
}

Match Completed Enum

{
UNDEFINED_MATCH_COMPLETION_TYPE = 0,
  MATCH_NOT_COMPLETED_TYPE = 1,
  FORFEIT_MATCH_COMPLETED_TYPE = 2,
  RETIREMENT_MATCH_COMPLETED_TYPE = 3,
  WITHDRAWAL_MATCH_COMPLETED_TYPE = 4,
  PLAYED_MATCH_COMPLETED_TYPE = 5,
}

Match Status Enum

{
UNDEFINED_MATCH_STATUS = 0,
  SCHEDULED_MATCH_STATUS = 1,
  IN_PROGRESS_MATCH_STATUS = 2,
  DELAYED_MATCH_STATUS = 3,
  COMPLETED_MATCH_STATUS = 4,
}

Penalty Type Reference Enum

{
UNDEFINED_PENALTY_TYPE = 0;
  TEHNICAL_WARNING = 1;
  TEHNICAL_FOUL = 2;
  VERBAL_WARNING = 3;
  TIME_VIOLATION_PENALTY = 4;
}

Log Type Reference Enum

{
  UNDEFINED_LOG_REFERENCE_TYPE = 0;
  EQUIPMENT_TIMEOUT = 1;
  CHALLENGE = 2;
  COIN_TOSS = 3;
  GAME_OVER = 4;
  FORFEIT = 5;
  MATCH_OVER = 6;
  MEDICAL_TIMEOUT = 7;
  MISSED_SERVE = 8;
  PENALTY = 9;
  PLAYERS_ON_COURT = 10;
  POINT_REPLAY = 11;
  POINT_IN_PROGRESS = 12;
  RETIREMENT = 13;
  POINT = 14;
  SERVE_SELECTION = 15;
  SIDE_OUT = 16;
  SWITCH_ENDS = 17;
  TIME_OUT = 18;
  TIME_VIOLATION = 19;
  WARMING_UP = 20;
  SUSPENSION = 21;
  START_SCORING = 22;
  SWITCH_SERVER = 23;
  TIME_IN = 24;
  COURT_ARRIVAL = 25;
  STATISTIC = 26;
  CHANGE_REFEREE = 27;
  CHECK_CONNECTION = 28;
  COLLECT_RALLY_STATISTIC = 29;
  WITHDRAWAL = 30;
  UNDO = 31;
  MOVE_PLAYERS = 32;
  CHANGE_SERVER = 33;
  REMOVE_PENALTY = 34;
  ADDITIONAL_TIMEOUT = 35;
  CHANGE_OF_SIDE = 36;
}

Log Types

Warming Up Log

{
  google.protobuf.Timestamp time_started = 1;
  google.protobuf.Timestamp time_ended = 2;
}

Equipment Timeout Log

{
  google.protobuf.Timestamp time_started = 1;
  google.protobuf.Timestamp time_ended = 2;
  string player_uuid = 3;
  string team_uuid = 4;
}

Medical Timeout Log

{
  google.protobuf.Timestamp time_started = 1;
  google.protobuf.Timestamp time_ended = 2;
  string player_uuid = 3;
  string team_uuid = 4;
  int64 timeout_type = 5;
}

Timeout Log

{
  google.protobuf.Timestamp time_started = 1;
  google.protobuf.Timestamp time_ended = 2;
  string player_uuid = 3;
  string team_uuid = 4;
  int64 timeout_type = 5;
  string note = 6;
}

Point Log

{
  google.protobuf.Timestamp time_started = 1;
  google.protobuf.Timestamp time_ended = 2;
  string player_uuid = 3;
  string team_uuid = 4;
  int64 start_score = 5;
  int64 end_score = 6;
  string server_uuid = 7;
  string receiver_uuid = 8;
  int64 rally_completed_type = 9;
}

Challenge Log

{
  string team_uuid = 1;
}

Coin Toss Log

{
  string team_uuid = 1;
}

Forfeit Log

{
  string team_uuid = 1;
}

Mised Serve Log

{
  string team_uuid = 1;
}

Withdrawal Log

{
  string team_uuid = 1;
}

Pently Log

{
  string team_uuid = 1;
  string penalty_note = 2;
  int64 penalty_type = 3;
}

Point Replay Log

{
  string team_uuid = 1;
  int64 replay_type = 2;
}

Point In Progress Log

{
  string team_uuid = 1;
}

Retirement Log

{
  string team_uuid = 1;
  int64 retirement_type = 2;
}

Server Selection Log

{
  string team_uuid = 1;
}

Side Out Log

{
  string team_uuid = 1;
}

Court Arrival Log

{
  google.protobuf.Timestamp team_one_on_court = 3;
  google.protobuf.Timestamp team_two_on_court = 4;
  string referee_uuid = 5;
  google.protobuf.Timestamp referee_on_court = 6;
}

Suspension Log

{
  google.protobuf.Timestamp time_started = 1;
  google.protobuf.Timestamp time_ended = 2;
  string note = 3;
  int64 suspension_type = 4;
}

Statistic Log

{
  string team_uuid = 1;
  string player_uuid = 2;
  int64 type = 3; //rally_completed_type
  int64 change = 4;
}

Game Over Log

{
  string team_uuid = 1;
}

Match Over Log

{
  string team_uuid = 1;
}

Change Referee Log

{
  string referee_uuid = 1;
  string referee_name = 2;
}

Empty Log

{
  string referee_uuid = 1;
  string referee_name = 2;
}

Empty Logs

{
  message GameOverLog {}
  message MatchOverLog {}
  message PlayersOnCourtLog {}
  message SwitchCourtSideLog {}
  message SwitchServerLog {}
  message WarmingUpLog {}
  message WeatherDelayLog {}
  message CheckConnectionLog {}
}

Change of side log

{
  string team_uuid = 1;
}

News Authors Referee App Pregame