*Introduction*

SoundCloud is an audio platform that enables sound creators to upload,
record, promote and share their originally-created sounds.In SoundCloud we
can follow favorite artists, labels and friends and see every track they
post.

The SoundCloud API exposes SoundCloud resources like sounds, sets and
users. These resources can be accessed and manipulated using the HTTP
methods GET, POST, PUT and DELETE. Basically SoundCloud API supports us to
maintain information about users, tracks, playlists, sounds, sets,etc.


*SoundCloud Connector Summary*

• Connector Name:  souncloud-connector-1.0.0
• Version: 1.0.0
• Technology:  REST


*Authentication*

SoundCloud API uses OAuth2 based authentication


*Selected API Methods*

*users*
    get user
    list of tracks of the user
    list of playlists (sets) of the user
    list of users who are followed by the user
    a user who is followed by the user
    list of users who are following the user
    user who is following the user
    list of comments from this user
    list of tracks favorited by the user
    track favorited by the user
    list of joined groups
    list of web profiles

*tracks*
    get a track
    comments for the track
    a comment for the track
    users who favorited the track
    a user who has favorited to the track
    users who have access to the track
    email addresses who are invited to the track
    secret token of the track


*playlists* - A SoundCloud Set is internally called playlists due to some
naming restrictions.
    get a playlist
    users who have access to the track
    email addresses who are invited to the playlist
    secret token of the playlist

*groups* - Groups have members and contributed tracks.
    get a group
    list of users who moderate the group
    list of users who joined the group
    list of users who contributed a track to the group
    list of users who contributed to, joined or moderate the group
    list of contributed and approved tracks
    list of contributed but not approved tracks (for moderators)
    a contributed but not approved track (for moderators)
    list of contributed tracks (for moderators). POST creates contribution
    a contributed track (for moderators)

*comments* - Comments can be made on tracks by any user who has access to a
track.

*me* -  Get information about the authenticated user and easily access
related subresources like tracks, followings, followers, groups.
    get authenticated user
    list of tracks of the user
    list of playlists (sets) of the user
    list of users who are followed by the user
    a user who is followed by the user
    list of users who are following the user
    user who is following the user
    list of comments from this user
    list of tracks favorited by the user
    track favorited by the user
    list of joined groups
    list of web profiles
    list dashboard activities
    list of connected external profiles

*connections* - Connections represent the external profiles (like twitter,
tumblr or facebook profiles and pages) that are connected to a SoundCloud
user.

*activities* - The newest activities for the logged-in user.

*apps* - All tracks that are created and uploaded using a published app.

*resolve* - The resolve resource allows to lookup and access API resources
when only know the SoundCloud.com URL.

*oembed* - oEmbed is an open standard to easily embed content from oEmbed
providers into the site.


Above are the methods that is going to be implemented in the soundcloud
connector. We have taken all the methods that are supported by the current
soundclound API.[1]

[1]http://developers.soundcloud.com/docs/api/reference

Please let us know the feedback on the above.

Thank you.
Gagani Amarathunga
_______________________________________________
Architecture mailing list
[email protected]
https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture

Reply via email to