# Sports Data Polling
This project contains source code and supporting files for the serverless application which polls game data for your favorite NHL team and get notified when your team scores.
This application has been initally developed for the Lightning project of Pacific Science Center to honor the Seattle Kraken team using SportRadar.com API endpoints.
More information about this project can be found here.
https://www.aboutamazon.com/news/aws/hockeys-newest-superfan-lights-up-seattle
You can change the team alias for your favorite NHL team according to documentation.
https://developer.sportradar.com/docs/read/hockey/NHL_v7#nhl-api-overview
The project has been developed as an AWS CDK application using Typescript.
Note: This repository is slightly different than the initial project so that the application can be used for individual interests while keeping the core functionalities and features the same.
## Prerequisites
- You will need an AWS Account and IAM User created as well as configured in your development environment for CDK Development
- More details how to create an AWS Account can be found here.
- More details how to create an IAM User here.
- More details how to get started with AWS CDK v2 here.
- You will need to create a developer account for sportradar.com here.
- Once registered, you will need to create an application.
- Make sure that `Issue a new key for NHL Trial` option has been selected while creating your application.
- You will be given a trial API key once you have created your application.
There are two endpoints that the application is using.
- Daily Schedule endpoint
- Game Boxscore endpoint
## Getting Started
```js
git clone https://github.com/aws-samples/aws-step-functions-sports-data-polling
```
```js
cd aws-step-functions-sports-data-polling
npm install
```
```js
cdk bootstrap
```
```js
cdk deploy --parameters teamId="sr:team:794340" --parameters emailAddress="your email address"
```
The parameter teamId is the id for your favorite NHL team used by sportradar.com. The default id is for Seattle Kraken but if you wanna change it for your favorite team, have a look at teams.json file for your team's id.
Once the application is deployed, it will automatically subscribe the email address that you provide as a parameter to the Scores topic.
Therefore, you will get a confirmation email similar to the following and you should confirm your subscription by clicking the "Confirm subscription" link to get scores in your email.
Note: This email address doesn't have to be the same email address you used for sportradar.com registration.
The last step is updating the API key called SportradarApiKey in AWS Systems Manager Parameter Store using your trial key from sportradar.com.
More info how to update a parameter can be found here
## Application Lifycycle
- The application will deploy the following main resources.
- An EventBridge Rule to trigger `check-games-lambda` function
- A Lambda function with the file `check-games-lambda`
- A Lambda function with the file `game-data-lambda`
- A Step Functions State Machine
- An SNS Topic with email subscription
- The EventBridge rule will invoke `check-games-lambda` function once a day at 8 AM PT. The lambda function will check the games scheduled for the day of invokation.
- If there is an NHL game for Seattle Kraken then the lambda function will create another EventBridge rule that will start an execution of the State Machine.
- The State Machine invokes the `game-data-lambda` function every minute. (This is intentionally high due to trial key limitations.)
- The `game-data-lambda` function checks the game data for scores.
- If there is a new score, the lambda function publishes this new score to the SNS topic.
- SNS topic notifies the subscribed email address automatically as below.
- When the game is over, the State Machine will stop the execution.