README.md

SoundcloudEx

SoundCloud api wrapper for Elixir. It provides simple HTTP authentication methods and client for api calls.

Installation

If available in Hex, the package can be installed as:

1. Add soundcloud_ex to your list of dependencies in mix.exs:

   def deps do [{:soundcloud_ex, "~> 0.0.1"}] end

##Examples ###OAuth2 authorization code flow

client = SoundcloudEx.Client.new(%{
  client_id: YOUR_CLIENT_ID,
  client_secret: YOUR_CLIENT_SECRET,
  redirect_uri: YOUR_REDIRECT_URI
})
auth_url = SoundcloudEx.Auth.authorization_url(client)

# Once you've redirected the user to `auth_url`, the user will complete the authentication
# on the SoundCloud login page. After that, SoundCloud will redirect the user to the
# `REDIRECT_URI` you've set. That's where you'll exchange the code passed via query string
# by SoundCloud with a fully-fledged access token.

SoundcloudEx.Auth.exchange_token(client, params["code"])

OAuth2 refresh token

client = SoundcloudEx.Client.new(%{
  client_id: YOUR_CLIENT_ID,
  client_secret: YOUR_CLIENT_SECRET
})

SoundcloudEx.Auth.refresh_token(client, YOUR_REFRESH_TOKEN) # A new fully-fledged access token.