Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Fixtures Push API v2 is a pub/sub or message queue mechanism for distributing updates in real time. The produced contracts are described in the Read Data Points section of each document under the /wiki/spaces/OTF/pages/3976890102 Domain Entities document.

Fixture push v2 uses the same contracts as Fixtures API v2, thus the API Swagger is also relevant for the push users to get a good understanding of the models they need. If going for the swagger take the /GET methods and see all “{Entity}ResponseModel” - e.g. FixtureResponseModel, CompetitionResponseModel etc.

...

Channel name

Contract published

Description

Localities

https://geniussports.atlassian.net/wiki/spaces/OTFBID/pages/39778392384447469789/Locality#Read-Data-Points

What is Locality? The locality entity has different meaning in different context:

  • For Fixture, Round, Season and Competition it defines the place where the entity will be held at.

  • For Competitor and Person it defines the nationality of the real-life Competitor/Person.

  • For Venue it defines the location of the venue in the real world.

Organizations

https://geniussports.atlassian.net/wiki/spaces/OTFBID/pages/39777407844447469767/Organization#Read-Data-Points

An Organization is representation of a real-life organization like the “NCAA” in the USA. It groups multiple Competitions within multiple Sports.

Venues

https://geniussports.atlassian.net/wiki/spaces/OTFBID/pages/39779047124447469853/Venue#Read-Data-Points

The venue entity defines different things in different context:

  • For Fixture, Round, Season, Competition: the place where the fixture take place

  • For Team: It defines the home venue of it

Persons

https://geniussports.atlassian.net/wiki/spaces/OTFBID/pages/39778392454447469885/Person#Read-Data-Points

Person is a representation of a real-life person

Players.{sportId}

https://geniussports.atlassian.net/wiki/spaces/OTF/pages/3976890114/Player+Competitor#Read-Data-Points

For this channel the consumer can subscribe directly to players which are part of specific sport by simply specifying the id of the sport in the channel’s name. e.g.: If you only want Tennis Players you can specify channel name: Players.24.

Teams.{sportId}

https://geniussports.atlassian.net/wiki/spaces/OTFBID/pages/39781340694447469885/Team+Competitor#Read-Data-Points

For this channel the consumer can subscribe directly to teams which are part of specific sport by simply specifying the id of the sport in the channel’s name. e.g.: If you only want Football Teams you can specify channel name: Teams.10.

Doubles.{sportId}

https://geniussports.atlassian.net/wiki/spaces/OTFBID/pages/39776425924447469885/DoublesPartnership+Competitor#Read-Data-Points

For this channel the consumer can subscribe directly to doubles which are part of specific sport by simply specifying the id of the sport in the channel’s name. e.g.: If you only want Tennis Doubles you can specify channel name: Doubles.24.

Contracts.{sportId}.{competitorId}

https://geniussports.atlassian.net/wiki/spaces/OTFBID/pages/39774787804447469885/Contract#Read-Data-Points

For this channel the consumer can subscribe directly to contracts which are part of specific sport and attached to specific competitor by simply specifying the id of the sport and the id of the competitor in the channel’s name. e.g.: If you only want Football Contracts for Barcelona you can specify channel name: Contracts.10.93471.

Competitions.{sportId}.{competitionId}

https://geniussports.atlassian.net/wiki/spaces/OTFBID/pages/39781996884447469885/Competition#Read-Data-Points

For this channel the consumer can subscribe directly to competitions which are part of specific sport by simply specifying the id of the sport and the competition id in the channel’s name. e.g.: If you only want Football Champions League Competition you can specify channel name: Competitions.10.19.

Seasons.{sportId}.{competitionId}

https://geniussports.atlassian.net/wiki/spaces/OTFBID/pages/39819346984447469885/Season#Read-Data-Points

For this channel the consumer can subscribe directly to seasons which are part of specific sport and specific competition by simply specifying the id of the sport and the competition id in the channel’s name. e.g.: If you only want Football Champions League Seasons you can specify channel name: Seasons.10.19.

Rounds.{sportId}.{competitionId}

https://geniussports.atlassian.net/wiki/spaces/OTFBID/pages/39775443304447469885/Round#Read-Data-Points

For this channel the consumer can subscribe directly to rounds which are part of specific sport and specific competition by simply specifying the id of the sport and the competition id in the channel’s name. e.g.: If you only want Football Champions League Rounds you can specify channel name: Rounds.10.19.

Fixtures.{sportId}.{competitionId}

https://geniussports.atlassian.net/wiki/spaces/OTFBID/pages/39777735054447469885/Fixture#Read-Data-Points

For this channel the consumer can subscribe directly to fixtures which are part of specific sport and specific competition by simply specifying the id of the sport and the competition id in the channel’s name. e.g.: If you only want Football Champions League Fixtures you can specify channel name: Fixtures.10.19.

SeasonCompetitors.{sportId}.{competitionId}

https://geniussports.atlassian.net/wiki/spaces/OTFBID/pages/41814922264447469885/Season+Competitor#Read-Data-Points

For this channel the consumer can subscribe directly to season competitors which are part of specific sport and specific competition by simply specifying the id of the sport and the competition id in the channel’s name. e.g.: If you only want Football Champions League Season Competitors you can specify channel name: SeasonCompetitors.10.19.

RoundCompetitors.{sportId}.{competitionId}

https://geniussports.atlassian.net/wiki/spaces/OTFBID/pages/41821473164447469885/Round+Competitor#Read-Data-Points

For this channel the consumer can subscribe directly to round competitors which are part of specific sport and specific competition by simply specifying the id of the sport and the competition id in the channel’s name. e.g.: If you only want Football Champions League Round Competitors you can specify channel name: RoundCompetitors.10.19.

...