Versions Compared
| Version | Old Version 1 | New Version 2 |
|---|---|---|
| Changes made by | ||
| Saved on |
Key
- This line was added.
- This line was removed.
- Formatting was changed.
...
| Section |
|---|
...
| not all data elements are available for all matches due to differing information availability and coverage methods. This document describes the V3 Handball match state contract. |
| Anchor | ||||
|---|---|---|---|---|
|
...
| Code Block | ||
|---|---|---|
| ||
{ "AwayTeam": [], |
...
"BallPossession": "Away", |
...
"CustomerId": "6265", |
...
"FirstHalfScore": [], |
...
"FixtureId": "4281889", |
...
"GameClock": [], |
...
"HomeTeam": [], |
...
"IsReliable": "true", |
...
"IsScoreConfirmed": "true", |
...
"MatchStatus": "PostMatch", |
...
"MessageTimestampUtc": "2017-05-30T10:54:22.995Z", |
...
"OvertimeOneFirstHalfScore": [], |
...
"OvertimeOneSecondHalfScore": [], |
...
"OvertimeTwoFirstHalfScore": [], |
...
"OvertimeTwoSecondHalfScore": [], |
...
"PenaltyShootoutScore": [], |
...
"PlayerCount": [], |
...
"Score": [], |
...
"SecondHalfScore": [], |
...
"Stats": [] |
...
} |
Element | Type | Description |
|---|---|---|
AwayTeam | Team | Describes away team |
BallPossession | PossessionTeamSide | Describes ball possession |
CustomerId | Integer | An immutable identifier for the customer |
FirstHalfScore | Score | Describes first half score |
FixtureId | String | An immutable identifier for the fixture |
GameClock | GameClock | Describes game clock |
HomeTeam | Team | Describes home team |
IsReliable | Boolean | True is data is reliable, false otherwise |
IsScoreConfirmed | Boolean | True if score is confirmed, false otherwise |
MatchStatus | MatchStatus | Described match status, possible values are: |
MessageTimestampUtc | DateTime | Describes message timestamp |
OvertimeOneFirstHalfScore | Score | Describes first over time first half score |
OvertimeOneSecondHalfScore | Score | Describes first over time second half score |
OvertimeTwoFirstHalfScore | Score | Describes second over time first half score |
OvertimeTwoSecondHalfScore | Score | Describes second over time first second half score |
PenaltyShootoutScore | Score | Describes penalty score |
PlayerCount | Score | Describes player count |
Score | Score | Describes the current score |
SecondHalfScore | Score | Describes second half score |
Stats | HandballStats | Describes stats |
GameClock
...
| Code Block | ||
|---|---|---|
| ||
{ "GameTime": "PT1H", |
...
"IsRunning": "false", |
...
"TimestampUtc": "2016-09-29T11:17:46.483Z" |
...
} |
Element | Type | Description |
|---|---|---|
GameTime | Duration | Describes game time |
IsRunning | Boolean | True if clock is running, false otherwise |
TimestampUtc | DateTime |
|
HandballStats
| Code Block | ||
|---|---|---|
| ||
{ |
...
"Possession": [], |
...
"SevenMeterThrowsAwarded": [], |
...
"SevenMeterThrowsMissed": [], |
...
"SevenMeterThrowsScored": [], |
...
"Suspensions": [], |
...
"Timeouts": [] |
...
} |
Element | Type | Description |
|---|---|---|
Possession | Score | Describes possesion |
SevenMeterThrowsAwarded | Score | Describes throws |
SevenMeterThrowsMissed | Score | Describes throws |
SevenMeterThrowsScored | Score | Describes throws |
Suspensions | Score | Describes suspensions |
Timeouts | Score | Describes timeouts |
Score
| Code Block | ||
|---|---|---|
| ||
{ |
...
"Home":0, |
...
"Away":2 |
...
} |
Element | Type | Description |
|---|---|---|
Home | Integer | The Home team's score |
Away | Integer | The Away team's score |
Team
| Code Block | ||
|---|---|---|
| ||
{ |
...
"ShirtColorMajor": "white", |
...
"ShirtColorMinor": "white" |
...
} |
Element | Type | Description |
|---|---|---|
ShirtColorMajor | String | Describes main shirt color |
ShirtColorMinor | String | Describes main shirt color |
| Anchor | ||||
|---|---|---|---|---|
|
The detail message lists every action that has happened in a handball match. This allows a complete timeline of the match to be constructed at any point.
| Code Block | ||
|---|---|---|
| ||
{ |
...
"AwayTeam": [], |
...
"BallPossession": "Away", |
...
"CustomerId": "6265", |
...
"FirstHalfScore": [], |
...
"FixtureId": "4281889", |
...
"GameClock": [], |
...
"HomeTeam": [], |
...
"IsReliable": "true", |
...
"IsScoreConfirmed": "true", |
...
"MatchStatus": "PostMatch", |
...
"MessageTimestampUtc": "2017-05-30T10:54:22.995Z", |
...
"OvertimeOneFirstHalfScore": [], |
...
"OvertimeOneSecondHalfScore": [], |
...
"OvertimeTwoFirstHalfScore": [], |
...
"OvertimeTwoSecondHalfScore": [], |
...
"PenaltyShootoutScore": [], |
...
"PlayerCount": [], |
...
"Score": [], |
...
"SecondHalfScore": [], |
...
"Stats": [], |
...
"MatchActions": [] |
...
} |
Element | Type | Description |
|---|---|---|
AwayTeam | Team | Describes away team |
BallPossession | PossessionTeamSide | Describes ball possession |
CustomerId | Integer | An immutable identifier for the customer |
FirstHalfScore | Score | Describes first half score |
FixtureId | String | An immutable identifier for the fixture |
GameClock | GameClock | Describes game clock |
HomeTeam | Team | Describes home team |
IsReliable | Boolean | True if data is reliable, false otherwise |
IsScoreConfirmed | Boolean | True if score is confirmed, false otherwise |
MatchStatus | MatchStatus | Described match status, possible values are: |
MessageTimestampUtc | DateTime | Describes message timestamp |
OvertimeOneFirstHalfScore | Score | Describes first over time first half score |
OvertimeOneSecondHalfScore | Score | Describes first over time second half score |
OvertimeTwoFirstHalfScore | Score | Describes second over time first half score |
OvertimeTwoSecondHalfScore | Score | Describes second over time second half score |
PenaltyShootoutScore | Score | Describes penalty score |
PlayerCount | Score | Describes player count |
Score | Score | Describes the current score |
SecondHalfScore | Score | Describes second half score |
Stats | HandballStats | Describes stats |
MatchActions | MatchActions | Describes match actions |
MatchActions
| Code Block | ||
|---|---|---|
| ||
{ |
...
"ClockActionCollection": [], |
...
"GoalCollection": [], |
...
"MatchStatusChangeCollection": [], |
...
"PlayerCountCollection": [], |
...
"PossessionChangeCollection": [], |
...
"SevenMeterThrowAwardedCollection": [], |
...
"SevenMeterThrowMissedCollection": [], |
...
"SuspensionCollection": [], |
...
"TimeoutCollection": [] |
...
} |
Element | Type | Description |
|---|---|---|
ClockActionCollection | ClockActionCollection |
|
GoalCollection | GoalCollection |
|
MatchStatusChangeCollection | MatchStatusChangeCollection |
|
PlayerCountCollection | PlayerCountCollection |
|
PossessionChangeCollection | PossessionChangeCollection |
|
SevenMeterThrowAwardedCollection | SevenMeterThrowAwardedCollection |
|
SevenMeterThrowMissedCollection | SevenMeterThrowMissedCollection |
|
SuspensionCollection | SuspensionCollection |
|
TimeoutCollection | TimeoutCollection |
|
ClockActionCollection
| Code Block | ||
|---|---|---|
| ||
{ |
...
"ClockActions": [], |
...
"IsCollected": "true", |
...
"IsReliable": "true" |
...
} |
Element | Type | Description |
|---|---|---|
ClockActions | ArrayOfClockAction |
|
IsCollected | Boolean | True if data is collected, false otherwise |
IsReliable | Boolean | True if data is reliable, false otherwise |
ArrayOfClockAction
| Code Block | ||
|---|---|---|
| ||
{ |
...
"IsConfirmed": "true", |
...
"MatchStatus": "FirstHalf", |
...
"TimeElapsedInPhase": "PT0S", |
...
"UtcTimestamp": "2016-09-29T09:59:39.144Z", |
...
"Adjustment": NULL, |
...
"IsRunning": "true", |
...
"Type": "Start" |
...
} |
Element | Type | Description |
|---|---|---|
IsConfirmed | Boolean | True if data is confirmed, false otherwise |
MatchStatus | MatchStatus | Described match status |
TimeElapsedInPhase | Duration | Describes time elapsed in phase |
UtcTimestamp | DateTime | Describes message timestamp |
Adjustment | Duration | Describes clock adjustment |
IsRunning | Boolean | True if clock is running, false otherwise |
Type | String | Describes update type, possible values are: |
GoalCollection
| Code Block | ||
|---|---|---|
| ||
{ |
...
"GoalCollection": [], |
...
"IsCollected": "true", |
...
"IsReliable": "true" |
...
} |
Element | Type | Description |
|---|---|---|
GoalCollection | ArrayOfGoal |
|
IsCollected | Boolean | True if data is collected, false otherwise |
IsReliable | Boolean | True if data is reliable, false |
...
otherwise |
ArrayOfGoal
| Code Block | ||
|---|---|---|
| ||
{ |
...
"IsConfirmed": "true", |
...
"MatchStatus": "FirstHalf", |
...
"TimeElapsedInPhase": "PT26S", |
...
"UtcTimestamp": "2016-09-29T10:00:05.96Z", |
...
"Team": "Away", |
...
"ScoredFromSevenMeterThrow": "false" |
...
} |
Element | Type | Description |
|---|---|---|
IsConfirmed | Boolean | True if data is confirmed, false otherwise |
MatchStatus | MatchStatus | Described match status |
TimeElapsedInPhase | Duration | Describes time elapsed in phase |
UtcTimestamp | DateTime | Describes message timestamp |
Team | Team | Describes the team |
ScoredFromSevenMeterThrow | Boolean | True if scored from seven meters, false otherwise |
MatchStatusChangeCollection
...
| Code Block | ||
|---|---|---|
| ||
{ "MatchStatusChanges": [], |
...
"IsCollected": "true", |
...
"IsReliable": "true" |
...
} |
Element | Type | Description |
|---|---|---|
MatchStatusChanges | ArrayOfMatchStatusChange |
|
IsCollected | Boolean | True if data is collected, false otherwise |
IsReliable | Boolean | True if data is reliable, false otherwise |
ArrayOfMatchStatusChange
| Code Block | ||
|---|---|---|
| ||
{ |
...
"IsConfirmed": "true", |
...
"MatchStatus": "FirstHalf", |
...
"TimeElapsedInPhase": "PT0S", |
...
"UtcTimestamp": "2016-09-29T09:59:39.144Z" |
...
} |
Element | Type | Description |
|---|---|---|
IsConfirmed | Boolean | True if data is confirmed, false otherwise |
MatchStatus | MatchStatus | Described match status |
TimeElapsedInPhase | Duration | Describes time elapsed in phase |
UtcTimestamp | DateTime | Describes message timestamp |
PlayerCountCollection
...
| Code Block | ||
|---|---|---|
| ||
{ "PlayerCounts": [], |
...
"IsCollected": "true", |
...
"IsReliable": "true" |
...
} |
Element | Type | Description |
|---|---|---|
PlayerCounts | ArrayOfPlayerCount |
|
IsCollected | Boolean | True if data is collected, false otherwise |
IsReliable | Boolean | True if data is reliable, false otherwise |
ArrayOfPlayerCount
...
| Code Block | ||
|---|---|---|
| ||
{ "IsConfirmed": "true", |
...
"MatchStatus": "FirstHalf", |
...
"TimeElapsedInPhase": "PT0S", |
...
"UtcTimestamp": "2016-09-29T09:59:39.144Z", |
...
"Count": [] |
...
} |
Element | Type | Description |
|---|---|---|
IsConfirmed | Boolean | True if data is confirmed, false otherwise |
MatchStatus | MatchStatus | Described match status |
TimeElapsedInPhase | Duration | Describes time elapsed in phase |
UtcTimestamp | DateTime | Describes message timestamp |
Count | Score | Describes the |
...
player count |
PossessionChangeCollection
| Code Block | ||
|---|---|---|
| ||
{ |
...
"PossessionChanges": [], |
...
"IsCollected": "true", |
...
"IsReliable": "true" |
...
} |
Element | Type | Description |
|---|---|---|
PossessionChanges | ArrayOfPossessionChange |
|
IsCollected | Boolean | True if data is collected, false otherwise |
IsReliable | Boolean | True if data is reliable, false otherwise |
ArrayOfPossessionChange
| Code Block | ||
|---|---|---|
| ||
{ |
...
"IsConfirmed": "true", |
...
"MatchStatus": "FirstHalf", |
...
"TimeElapsedInPhase": "PT1S", |
...
"UtcTimestamp": "2016-09-29T09:59:40.712Z", |
...
"Possession": "Away" |
...
} |
Element | Type | Description |
|---|---|---|
IsConfirmed | Boolean | True if data is confirmed, false otherwise |
MatchStatus | MatchStatus | Described match status |
TimeElapsedInPhase | Duration | Describes time elapsed in phase |
UtcTimestamp | DateTime | Describes message timestamp |
Possession | Team | Describes the team |
SevenMeterThrowAwardedCollection
| Code Block | ||
|---|---|---|
| ||
{ |
...
"SevenMeterThrowsAwarded": [], |
...
"IsCollected": "true", |
...
"IsReliable": "true" |
...
} |
Element | Type | Description |
|---|---|---|
SevenMeterThrowsAwarded | ArrayOfSevenMeterThrowAwarded |
|
IsCollected | Boolean | True if data is collected, false otherwise |
IsReliable | Boolean | True if data is reliable, false otherwise |
ArrayOfSevenMeterThrowAwarded
| Code Block | ||
|---|---|---|
| ||
{ |
...
"IsConfirmed": "true", |
...
"MatchStatus": "FirstHalf", |
...
"TimeElapsedInPhase": "PT1S", |
...
"UtcTimestamp": "2016-09-29T09:59:40.712Z", |
...
"Team": "Away" |
...
} |
Element | Type | Description |
|---|---|---|
IsConfirmed | Boolean | True if data is confirmed, false otherwise |
MatchStatus | MatchStatus | Described match status |
TimeElapsedInPhase | Duration | Describes time elapsed in phase |
UtcTimestamp | DateTime | Describes message timestamp |
Team | Team | Describes the team |
SevenMeterThrowMissedCollection
...
| Code Block | ||
|---|---|---|
| ||
{ "SevenMeterThrowsMissed": [], |
...
"IsCollected": "true", |
...
"IsReliable": "true" |
...
} |
Element | Type | Description |
|---|---|---|
ClockActions | ArrayOfSevenMeterThrowMissed |
|
IsCollected | Boolean | True if data is collected, false otherwise |
IsReliable | Boolean | True if data is reliable, false otherwise |
ArrayOfSevenMeterThrowMissed
| Code Block | ||
|---|---|---|
| ||
{ |
...
"IsConfirmed": "true", |
...
"MatchStatus": "FirstHalf", |
...
"TimeElapsedInPhase": "PT1S", |
...
"UtcTimestamp": "2016-09-29T09:59:40.712Z", |
...
"Team": "Away" |
...
} |
Element | Type | Description |
|---|---|---|
IsConfirmed | Boolean | True if data is confirmed, false otherwise |
MatchStatus | MatchStatus | Described match status |
TimeElapsedInPhase | Duration | Describes time elapsed in phase |
UtcTimestamp | DateTime | Describes message timestamp |
Team | Team | Describes the team |
SuspensionCollection
...
| Code Block | ||
|---|---|---|
| ||
{ "Suspensions": [], |
...
"IsCollected": "true", |
...
"IsReliable": "true" |
...
} |
Element | Type | Description |
|---|---|---|
Suspensions | ArrayOfSuspension |
|
IsCollected | Boolean | True if data is collected, false otherwise |
IsReliable | Boolean | True if data is reliable, false otherwise |
ArrayOfSuspension
| Code Block | ||
|---|---|---|
| ||
{ |
...
"IsConfirmed": "true", |
...
"MatchStatus": "FirstHalf", |
...
"TimeElapsedInPhase": "PT24M2S", |
...
"UtcTimestamp": "2016-09-29T10:27:13.853Z", |
...
"Team": "Away", |
...
"IsFinished": "true", |
...
"StartedAt": "PT24M2S" |
...
} |
Element | Type | Description |
|---|---|---|
IsConfirmed | Boolean | True if data is confirmed, false otherwise |
MatchStatus | MatchStatus | Described match status |
TimeElapsedInPhase | Duration | Describes time elapsed in phase |
UtcTimestamp | DateTime | Describes message timestamp |
Team | Team | Describes the team |
IsFinished | Boolean | True if suspension is finished, false otherwise |
StartedAt | Duration | Describes the start of the suspension |
TimeoutCollection
| Code Block | ||
|---|---|---|
| ||
{ |
...
"Timeouts": [], |
...
"IsCollected": "true", |
...
"IsReliable": "true" |
...
} |
Element | Type | Description |
|---|---|---|
Timeouts | ArrayOfTimeout |
|
IsCollected | Boolean | True if data is collected, false otherwise |
IsReliable | Boolean | True if data is reliable, false otherwise |
ArrayOfTimeout
| Code Block | ||
|---|---|---|
| ||
{ |
...
"IsConfirmed": "true", |
...
"MatchStatus": "FirstHalf", |
...
"TimeElapsedInPhase": "PT5M52S", |
...
"UtcTimestamp": "2016-09-29T10:05:32.533Z", |
...
"Team": "Home" |
...
} |
Element | Type | Description |
|---|---|---|
IsConfirmed | Boolean | True if data is confirmed, false otherwise |
MatchStatus | MatchStatus | Described match status |
TimeElapsedInPhase | Duration | Describes time elapsed in phase |
UtcTimestamp | DateTime | Describes message timestamp |
Team | Team | Describes the team |
...