plano/demos/integrations/spotify_bearer_auth/README.md

31 lines
1.6 KiB
Markdown

# Use Case Demo: Bearer Authorization with Spotify APIs
In this demo, we show how you can use Plano's bearer authorization capability to connect your agentic apps to third-party APIs.
More specifically, we demonstrate how you can connect to two Spotify APIs:
- [`/v1/browse/new-releases`](https://developer.spotify.com/documentation/web-api/reference/get-new-releases)
- [`/v1/artists/{artist_id}/top-tracks`](https://developer.spotify.com/documentation/web-api/reference/get-an-artists-top-tracks)
Where users can engage by asking questions like _"Show me the latest releases in the US"_, followed by queries like _"Show me top tracks from Taylor Swift"_.
![Example of Bearer Authorization with Spotify APIs](spotify_bearer_auth.png)
## Starting the demo
1. Ensure the [prerequisites](https://github.com/katanemo/arch/?tab=readme-ov-file#prerequisites) are installed correctly.
2. Create an `.env` file with API keys for OpenAI and Spotify.
- Sign up for an OpenAI API key at [https://platform.openai.com/signup/](https://platform.openai.com/signup/)
- Sign up for a Spotify Client Key/Secret by following instructions at [https://developer.spotify.com/dashboard/](https://developer.spotify.com/dashboard/)
- Generate a Spotify token using the [https://accounts.spotify.com/api/token API](https://accounts.spotify.com/api/token), using ```curl``` or similar commands.
- Create a .env file with the following keys:
```
OPENAI_API_KEY=your_openai_api_key
SPOTIFY_CLIENT_KEY=your_spotify_api_token
```
3. Start Plano
```sh
sh run_demo.sh
```
4. Navigate to http://localhost:18080
5. Ask "show me new album releases in the US"