Schema

What does the notification message look like?

The notification message contains all the relevant information to inform a client which endpoint has updated.

JSON

{
	"operation": "update",
	"timestamp": "2016-01-19T09:32:55Z",
	"type": "event",
	"url": "http://sport.api.press.net/v1/event/2112825?ts=1453195816",
	"event": {
		"id": 2112825,
		"name": "Roger vs Tim",
		"status": "Finished",
		"date": "2016-01-19T09:32:55Z"
	},
	"stage": {
		"id": 21413,
		"name": "Cup"
	},
	"tournament": {
		"id": 13444,
		"name": "Tennis Cup"
	},
	"season": {
		"id": 551,
		"name": "2016"
	},
	"sport": {
		"id": 3,
		"name": "Tennis"
	},
	"_ts": 1453195816
}

Key (JsonPath)	Description	Example/Values
$.operation	Notification Operation	create update * delete
$.timestamp	Creation time	2016-01-19T09:32:55Z
$.type	Type of Entity Updated	sport country venue tournament season stage draw standing event event:actions * event:composition
$.url	URL to retrieve latest entity	http://sport.api.press.net/v1/event/2112825?ts=1453195816
$.event	Event Entity	Entity*
$.stage	Stage Entity	Entity*
$.tournament	Tournament Entity	Entity*
$.season	Season Entity	Entity*
$.sport	Sport Entity	Entity*
$._ts	Unix Timestamp	1453195816

👍

_ts

Used to cache bust API requests to allow the most up to date data.

The following table defines the Entity* Properties.

Key	Description	Example
id	Entity ID	2112825
name	Entity Name	Roger vs Tim
status	Optional Status value*	Finished
date	Option Date for Entity*	2016-01-19T09:32:55Z

👍

Optional Values

status and date are only available on the Event type notifcations

Browse the tabs below to see some real examples of the notification messages.

Tournament

{
  "operation": "update",
  "timestamp": "2016-01-19T09:32:55Z",
  "type": "tournament",
  "url": "http://sport.api.press.net/v1/tournament/156?ts=1453195816",  
  "tournament": {
    "id": 156,
    "name": "ATP"
  },
  "sport": {
    "id": 2,
    "name": "Tennis"
  }
  "_ts": 1453195816
}

Stage

{
  "operation": "update",
  "timestamp": "2016-01-19T09:32:55Z",
  "type": "stage",
  "url": "http://sport.api.press.net/v1/stage/841267?ts=1453195816",  
  "stage":{
    "id": 841267,
    "name": "Delray Beach International Tennis Championships"
  },
  "season": {
    "id": 9773,
    "name": "2016"
  },
  "tournament": {
    "id": 156,
    "name": "ATP"
  },
  "sport": {
    "id": 2,
    "name": "Tennis"
  }
  "_ts": 1453195816
}

Draw

{
  "operation": "update",
  "timestamp": "2016-01-19T09:32:55Z",
  "type": "draw",
  "url": "http://sport.api.press.net/v1/draw/7433?ts=1453195816",  
  "draw":{
    "id": 7433,
    "name": "BDO World Championship Male Single"
  },
  "season": {
    "id": 9985,
    "name": "2016"
  },
  "tournament": {
    "id": 9280,
    "name": "BDO World Championship 1"
  },
  "sport": {
    "id": 77,
    "name": "Darts"
  },
  "_ts": 1453195816
}

Standing

{
  "operation": "update",
  "timestamp": "2016-01-19T09:32:55Z",
  "type": "standing",
  "url": "http://sport.api.press.net/v1/standing/27743?ts=1453195816"  
  "standing":{
    "id": 27743,
    "name": "FIFA World Ranking (male)"
  },
  "sport": {
    "id": 1,
    "type": "Soccer"
  },
  "_ts": 1453195816
}

Event

{
  "operation": "update",
  "timestamp": "2016-01-19T09:32:55Z",
  "type": "event",
  "url": "http://sport.api.press.net/v1/event/2112825?ts=1453195816",  
  "event":{
    "id": 2112825,
    "type": "event",
    "status": "Finished",
    "date": "2015-10-04T20:00:00+0000"
  },
  "stage": {
    "id": 838880,
    "name": "World Grand Prix"
  },
  "season": {
    "id": 9190,
    "name": "2015"
  },
  "tournament": {
    "id": 9279,
    "name": "World Grand Prix 1"
  },
  "sport": {
    "id": 77,
    "name": "Darts"
  },
  "_ts": 1453195816
}

Event Actions

{
  "operation": "update",
  "timestamp": "2016-01-19T09:32:55Z",
  "type": "event:actions",
  "url": "http://sport.api.press.net/v1/event/1992996/actions?ts=1453195816",  
  "event":{
    "id": 2112825,
    "type": "event",
    "status": "Finished",
    "date": "2015-10-04T20:00:00+0000"
  },
  "stage": {
    "id": 838880,
    "name": "World Grand Prix"
  },
  "season": {
    "id": 9190,
    "name": "2015"
  },
  "tournament": {
    "id": 9279,
    "name": "World Grand Prix 1"
  },
  "sport": {
    "id": 77,
    "name": "Darts"
  },
  "_ts": 1453195816
}

Event Composition

{
  "operation": "update",
  "timestamp": "2016-01-19T09:32:55Z",
  "type": "event:composition",
  "url": "http://sport.api.press.net/v1/event/2112825/composition?ts=1453195816",
  "event":{
    "id": 2112825,
    "type": "event",
    "status": "Finished",
    "date": "2015-10-04T20:00:00+0000"
  },
  "stage": {
    "id": 838880,
    "name": "World Grand Prix"
  },
  "season": {
    "id": 9190,
    "name": "2015"
  },
  "tournament": {
    "id": 9279,
    "name": "World Grand Prix 1"
  },
  "sport": {
    "id": 77,
    "name": "Darts"
  },
  "_ts": 1453195816
}