octoplus-coffee-check/README.md

14 lines
918 B
Markdown

# Octoplus Coffee Check
[Octopus Energy](https://octopus.energy) give away free coffee to customers each week, but since they started releasing codes every day, rather than at the start of each week, I'm struggling to get them. This is a simple tool that will check for available coffee codes and notify via a webhook.
## Usage
Setup a cronjob to run the script with `deno run -A main.ts`.
The following environment variables are configurable:
- **`OCTOPUS_API_KEY`** - your Octopus Energy API key, [available here](https://octopus.energy/dashboard/new/accounts/personal-details/api-access)
- **`OCTOPUS_ACCOUNT_NUMBER`** - your Octopus Energy account number (like `A-XXXXXXXX`)
- **`WEBHOOK_URL`** - a webhook to your messaging service of choice (e.g. Discord, Slack, etc...)
- _`STATE_FILENAME` - this sets the location of the script's state. By default it'll be `state.json` in the current working directory._