Objects

BOS Objects

The following objects are used to pass data to, or objects from response messages, the five API endpoints:

• add_game

• start_game

• add_Score

• finish_Game

• cancel_Game

create

Parameters for new BOS incident message to create a game and add to Couch Potato database.

Object

Parameter	Description	Type	Required
sport	Sport name	String	Yes
league	League (Event Group) of sport	String	Yes
home	Home team name	String	Yes
away	Away team name	String	Yes
start_time	Start date/time of game	Date	Yes
user	Current user id	Number	Yes

Example

{
  "sport": "Soccer",
  "league": "EPL",
  "home": "Norwich City",
  "away": "Manchester City",
  "start_time": "2020-02-04T18:33:00Z",
  "user": 35,
  "match_id": 60
}

in_progress

Parameters for new BOS incident message to start a game and add to Couch Potato database.

Object

Parameter	Description	Type	Required
sport	Sport name	String	Yes
league	League (Event Group) of sport	String	Yes
home	Home team name	String	Yes
away	Away team name	String	Yes
start_time	Start date/time of game	Date	Yes
whistle_start_time	Actual time the game started	Date	Yes
match_id	Unique match identifier	Number	Yes

Example

{
  "sport": "Soccer",
  "league": "EPL",
  "home": "Norwich City",
  "away": "Manchester City",
  "start_time": "2020-02-04T18:33:00Z",
  "match_id": 60,
  "whistle_start_time": "2020-02-04T18:40:00Z"
}

result

Parameters for new BOS incident message to set the score of a game and add to Couch Potato database.

Object

Parameter	Description	Type	Required
sport	Sport name	String	Yes
league	League (Event Group) of sport	String	Yes
home	Home team name	String	Yes
away	Away team name	String	Yes
start_time	Start date/time of game	Date	Yes
home_score	The score for the home team	Number	Yes
away_score	The score for the away team	Number	Yes
match_id	Unique match identifier	Number	Yes

Example

{
  "sport": "Soccer",
  "league": "EPL",
  "home": "Norwich City",
  "away": "Manchester City",
  "start_time": "2020-02-04T18:33:00Z",
  "home_score": 1,
  "away_score": 4,
  "match_id": 60
}

finish

Parameters for new BOS incident message to finish/complete a game and add to Couch Potato database.

Object

Parameter	Description	Type	Required
sport	Sport name	String	Yes
league	League (Event Group) of sport	String	Yes
home	Home team name	String	Yes
away	Away team name	String	Yes
start_time	Start date/time of game	Date	Yes
whistle_end_time	The time the game ended	Date	Yes
away_score	The score for the away team	Number	Yes
match_id	Unique match identifier	Number	Yes

Example

{
  "sport": "Soccer",
  "league": "EPL",
  "home": "Norwich City",
  "away": "Manchester City",
  "start_time": "2020-02-04T18:33:00Z",
  "match_id": 60,
  "whistle_end_time": "2020-02-04T20:30:00Z"
}

canceled

Parameters for new BOS incident message to cancel a game and add to Couch Potato database.

Object

Parameter	Description	Type	Required
sport	Sport name	String	Yes
league	League (Event Group) of sport	String	Yes
home	Home team name	String	Yes
away	Away team name	String	Yes
start_time	Start date/time of game	Date	Yes
match_id	Unique match identifier	Number	Yes

Example

{
  "sport": "Soccer",
  "league": "EPL",
  "home": "Norwich City",
  "away": "Manchester City",
  "start_time": "2020-02-04T18:33:00Z",
  "match_id": 60,
}

Success Response Objects

Add Game Success Response

Object attributes for a 200 response from an add_game call.

Attributes

Name	Text
status	Always 200
title	Game added
message	[home ] v [away ] - [start_time]

Example

{
    "status":"200",
    "title":"Game added",
    "message":"Arsenal v Liverpool - 2020-02-25T01:33:00.000Z"
}

Start Game Success Response

Object attributes for a 200 response from an start_game call.

Attributes

Name	Text
status	Always 200
title	Game started
message	[home ] v [away ] - [whistle_start_time]

Example

{
    "status":"200",
    "title":"Game started",
    "message":"Chelsea v Chelsea - [whistle_start_time]2020-02-04T18:05:47.736Z"
}

Add Score Success Response

Object attributes for a 200 response from an add_score call.

Attributes

Name	Text
status	Always 200
title	Scores added
message	[home ] [home_score]v [away ][away_score]

Example

{
    "status":"200",
    "title":"Scores added",
    "message":"Chelsea 4 v Arsenal 2"
}

Finish Game Success Response

Object attributes for a 200 response from an finish_game call.

Attributes

Name	Text
status	Always 200
title	Game finished
message	[home ] v [away ] - [whistle_end_time]

Example

{
    "status":"200",
    "title":"Game finished",
    "message":"Liverpool v Arsenal - [whistle_end_time]2020-02-03T22:45:00.000Z"
}

Cancel Game Success Response

Object attributes for a 200 response from an cancel_game call.

Attributes

Name	Text
status	Always 200
title	Game canceled
message	[home ] v [away ]