Versions Compared

Key

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

...

The default value for sportApiVersion is v1.

Ably Access Revocation (Access Control API v2 Only)

The Access Control v2 API introduces the option to revoke access for a specific resource - the combination of feed (e.g. match state), source, sport, fixture and sportApiVersion.

Revocation can be requested with the same URL you used to request access by adding /revoke and using the HTTP POST method.

Note

Revoking access to a resource will revoke all access tokens for that specific resource for your credentials.

Panel
panelIconId2757
panelIcon:exclamation:
panelIconText
bgColor#FFBDAD

Revocation will block new tokens for the same resource for 1 hour. It is recommended to only use this if access to the resource is not going to be needed.

Note

Tokens issued from V1 Access Control cannot be revoked from V2 Access Control.

Revocation is only allowed for fixturesin the future. If a fixture has already started, attempting to revoke access will result in a 400 (Bad Request) response.

Example revocation of match state:

Code Block
curl -X POST -H 'x-api-key: YOUR-API-KEY' -H 'Authorization: YOUR-ACCESS-TOKEN'
https://platform.matchstate.api.geniussports.com/api/v2/sources/GeniusPremium/sports/17/fixtures/10324/liveaccess/matchstate/revoke?sportApiVersion=v1

Technical Support

Support Team Contact Details

...