KayLerch / alexa-flashbriefing-soundcloud-gateway

This gateway-service pulls your Soundcloud-RSS-feed and converts audio-feed-urls to HTTPS in order to comply with SSL requirements for audio-feeds in Alexa Flash-Briefing skills

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Alexa Flash-Briefing Gateway for Soundcloud Podcasts

alt text

This gateway-service pulls your Soundcloud-RSS-feed and converts audio-feed-urls to HTTPS in order to comply with SSL requirements for audio-feeds for Alexa Flash-Briefing skills. Secondly, the script also picks the first configurable X items of your Soundcloud feed and returns it for your Flash-Briefing by cutting off the trailing (likely outdated) feed items.

Before you start, make sure you configured your Podcast's RSS feed in Soundcloud (Howto)

  1. Deploy the Serverless-stack with "serverless deploy" in your CLI (don't forget to set AWS credentials in your environment). Adjust serverless.yml in case you want your stack be deployed in different AWS region than eu-west-1.

  2. Use the AWS API-Gateway endpoint you'll find in the console output once your stack is deployed and use it as your Flash-Briefing skill-endpoint. You have to provide the Soundcloud-UserId as a GET parameter and optionally can limit the returned feed items to an individual max (by default it is set to 1 meaning only the top-most feed item in your Podcast will be returned).

Example

When this is your RSS-feed-Url in Soundcloud:

https://feeds.soundcloud.com/users/soundcloud:users:555123456/sounds.rss

your Soundcloud-UserId is 555123456.

After your deployed your serverless stack in step 2) you should use the returned url and provide your Soundcloud-UserId as a GET parameter. If you don't give it the uid-paramter the endpoints responds with an internal server error.

https://xxx9t1mxxx.execute-api.eu-west-1.amazonaws.com/prod/feed?uid=555123456

Optionally, you can limit the number of returned feed items (by default the limit is 1)

https://xxx9t1mxxx.execute-api.eu-west-1.amazonaws.com/prod/feed?uid=555123456&limit=3

About

This gateway-service pulls your Soundcloud-RSS-feed and converts audio-feed-urls to HTTPS in order to comply with SSL requirements for audio-feeds in Alexa Flash-Briefing skills

License:Apache License 2.0


Languages

Language:JavaScript 100.0%