Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

7digital-api

Package Overview
Dependencies
Maintainers
1
Versions
87
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

7digital-api

7digital API client for nodeJS

  • 0.13.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
308
increased by93.71%
Maintainers
1
Weekly downloads
 
Created
Source

7digital Node.js API Client

Current head build status:

Build Status

About 7digital

7digital.com is an online music store operating in over 16 countries and offering more than 11 million high quality DRM free MP3s (320kbps) from all major labels and wide range of idependent labels and distributors. 7digital API will give you access to the full catalogue including high quality album art, 30s preview clips for all tracks, commissions on sales, integrated purchasing and full length streaming. More details at developer.7digital.net

WHAT IS THIS?

A serverside javascript wrapper round the 7digital API which returns the responses parsed into JavaScript objects. Full code documentation can be found here

INSTALLATION

NPM

Install it via npm

npm install --save 7digital-api

USAGE

See the examples folder for examples of how to use this. If you have included 7digital-api in your dependencies in the package.json file, you can use the like so:

var api = require('7digital-api'),
    artists = new api.Artists();

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

If you need to supply your own config or want XML responses, you do so like this:

var api, artists;

api = require('7digital-api').configure({
    format: 'XML',
    consumerkey: 'MY_KEY_HERE',
    consumersecret: 'MY_SECRET_HERE',
});

artists = new api.Artists();

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

See oauth.js in the examples folder for an example of how to acquire an oauth access token to access any of the protected endpoints.

The bundled OAuth module must be used in place of a standard OAuth client

require('7digital-api').oauth,

This is to ensure the tokens are correctly parsed from the XML response.

See developer.7digital.net for full details of the API endpoints and the parameters they accept.

TESTS

To run the unit tests:

npm test

There are also integration tests. Tests for various error handling scenarios are run against a stub 7d api. It can be installed with:

npm install git://github.com/7digital/api-stub.git

Some of the integration tests (around the client's handling of OAuth) run against the real 7d api. In order for these tests to work, several environment variables need to be set:

  • NODE_API_CLIENT_TESTS_CONSUMER_KEY
  • NODE_API_CLIENT_TESTS_CONSUMER_SECRET

Your 7d api key and secret, which can be obtained from http://access.7digital.com/partnerprogram

  • NODE_API_CLIENT_TESTS_VOUCHER_CODE

The code for a voucher which can be applied to a basket containing an item of 1p, used for a two-legged OAuth test.

  • NODE_API_CLIENT_TESTS_USER_TOKEN
  • NODE_API_CLIENT_TESTS_USER_SECRET

A token and secret for access to any user's resources for a given consumer key and secret. These are used for 3-legged OAuth tests, and can be obtained by running node ./examples/oauth.js and following the prompts.

If these vars are set, the tests can then be run with:

mocha spec-integration/

Keywords

FAQs

Package last updated on 20 Mar 2014

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc