API Libraries & Examples

API Wrappers

• .Net
• Python
• Ruby
• Node.js

.Net

• .Net Fluent C# Wrapper
  Example usage:
  

  Artist artist = Api<artist>.Get

                 .WithArtistId(1)

                 .Please()

  (See example usage console app project for some more examples.)

Python

• python-7Digital (py7D) by Jason Rubenstein
  Example usage:
  

  # set your oauth_consumer_key, oauth_consumer_secret, and country in the api_settings.py

  module.import py7D

  results = py7D.request('artist', 'search', q='black', page=1, pageSize=20)

  OAuth signed request:

  py7D.oauth_request('user', 'locker', access_token)

• Python Wrapper
  Example usage:
  

  import py7digital

  #Search artist

  results = py7digital.search_artist('stones')

  print results.get_total_result_count()

  for artist in results.get_next_page():

    print artist.get_name() #, artist.get_image(), artist.get_url(), artist.get_tags()

    print '\tTop tracks:'

    for top_track in artist.get_top_tracks():

      print '\t\t', top_track.get_title(), top_track.get_isrc(), top_track.get_duration()

  (forked from Python Wrapper by Òscar Celma)

Ruby

• Ruby Wrapper
  Example usage:
  

  require "sevendigital"

  sevendigital_client = Sevendigital::Client.new(:oauth_consumer_key => "YOUR_KEY_HERE")

  artist = sevendigital_client.artist.get_details(1)

    puts "#{artist.name}"

    artist.releases.each do |release|

        puts "#{release.year} - #{release.title}"

        puts "#{release.tracks.size} tracks for #{release.price.formatted_price}"

    end

Node.js

• Node.js Wrapper by Raoul Millais
  Example usage:
  

  var api = require('7digital-api'),

      artists = new api.Artists();

  artists.getReleases({ artistid: 1 }, function(err, data) {

      console.dir(data);

  });

  
  Example of using the Node.js wrapper for OAuth authentication: http://raoulmillais.github.com/node-7digital-api/oauth.html

  Example Apps with source code

  
  
  • OAuth Console (C#)
    useful for testing API methods requiring OAuth signed requests - download windows excutable
  • Random Album Recommender (Ruby on Rails)
    a simple Ruby on Rails example using the Ruby Wrapper
  • PHP Exmaple (PHP)
    variation of the above randomizer in PHP
  • Piracy (Ruby on Rails - source code)
    "An android application allowing ye t' drop tracks from yer music collection on yer current location, n' allowing others t' pick 'em up if they be close enough." Check out the demo video.
    Winner of the 7digital Prize at Music Hack Day London 2010
  • Playlistr (Ruby on Rails - source code)

  OAuth

  Plenty of OAuth libraries for different languages can be found at oauth.net.

  
  
  

  If you have anything you'd like to contribute with please let us know at api@7digital.com.