(Dis)connection States

There are three connection statuses for the golf live data:

Connected: Connection is healthy, all scoring devices currently scoring that team for that round are fully connected and operational

Partially Disconnected: There is an issue with connection on some devices or networks, we cannot be entirely sure that data will come through in a timely manner.

Disconnected: All scoring devices are disconnected and we should not expect data for that

1. Disconnected

This packet will be sent to indicate that we are totally disconnected to all devices scoring for a team playing a round. You will only receive this packet once – Assume that the state of the round is disconnected until you receive either a Partially Disconnected or a Connected packet.

Response Model

Disconnected Object

Field Name	Type	Description
timestamp	date	The timestamp of the event, in UTC
eventElementType	string	The type of event, in this case always “ConnectionStateChanged
state	string	The type of state, in this case “Disconnected”

Sample Event Packet

{
    "timestamp": "2017-01-05T17:00:49.087Z",
    "eventElementType": "ConnectionStateChanged",
    "state": "Disconnected"
}

2. Partial Disconnection

This packet will be sent to indicate that there is an issue with connection on some devices or networks and that we cannot be entirely sure that data will come through in a timely manner. You will only receive this packet once – Assume that the state of the round is partially disconnected until you receive either an Disconnected or Connected packet.

Response Model

Partially Disconnected Object

Field Name	Type	Description
timestamp	date	The timestamp of the event, in UTC
eventElementType	string	The type of event, in this case always “ConnectionStateChanged
state	string	The type of state, in this case “PartiallyDisconnected”

{
    "timestamp": "2017-01-05T17:00:49.087Z",
    "eventElementType": "ConnectionStateChanged",
    "state": "PartiallyDisconnected"
}

3. Connected

This packet will be sent to indicate that we are now connected to all scoring devices via all networks for a team playing a round. It will be issued after a Disconnected packet to indicate connection is now back, or at any time after you have received a Partially Disconnected packet.

Response Model

Connected Object

Field Name	Type	Description
timestamp	date	The timestamp of the event, in UTC
eventElementType	string	The type of event, in this case always “ConnectionStateChanged
state	string	The type of state, in this case “Connected”

Sample Event Packet

{
    "timestamp": "2017-01-05T17:00:49.087Z",
    "eventElementType": "ConnectionStateChanged",
    "state": "Connected"
}

Doc navigation

← Hole Score Update