Skip to content

Latest commit

 

History

History
106 lines (93 loc) · 5.87 KB

README.md

File metadata and controls

106 lines (93 loc) · 5.87 KB
Raw

angular-bandsintown-api-factory is an angularjs module with a bandsintown v2 api factory.

npm version Bower version

Author: Jonathan Hornung (JohnnyTheTank)

Usage

  1. Install via either bower, npm or downloaded files:

    1. bower install --save angular-bandsintown-api-factory
    2. npm install --save angular-bandsintown-api-factory
    3. download angular-bandsintown-api-factory.zip

  2. Include dependencies in your HTML.

    1. When using bower:
    <script src="bower_components/angular-bandsintown-api-factory/dist/angular-bandsintown-api-factory.min.js"></script>
    1. When using npm:
    <script src="node_modules/angular-bandsintown-api-factory/dist/angular-bandsintown-api-factory.min.js"></script>
    1. when using downloaded files
    <script src="angular-bandsintown-api-factory.min.js"></script>

  3. Add jtt_bandsintown to your application's module dependencies.

  4. Use the factory bandsintownFactory

factory methods

getArtist

Get all parameters here

// all parameters: http://bandsintown.com/api/requests#artists-get
bandsintownFactory.getArtist({
    artist:"<ARTIST_NAME>", // ? and / characters must be double escaped. Artists such as "AC/DC" will end up as "AC%252FDC"
    artist_id:"<ARTIST_ID>", // (optional) fallback: mbid_<id> (MusicBrainz ID), fbid_<id> (Facebook Page ID)
    app_id:"<YOUR_APP_ID>", //The application ID can be anything, but should be a word that describes your application or company.
}).then(function (_data) {
    //on success
}).catch(function (_data) {
    //on error
});

getEvents

Get all parameters here

// all parameters: http://bandsintown.com/api/requests#artists-events
bandsintownFactory.getEventsFromArtist({
    artist:"<ARTIST_NAME>", // ? and / characters must be double escaped. Artists such as "AC/DC" will end up as "AC%252FDC"
    artist_id:"<ARTIST_ID>", // (optional) fallback: mbid_<id> (MusicBrainz ID), fbid_<id> (Facebook Page ID)
    date:"<DATE>", // (optional) (default: upcoming) yyyy-mm-dd || yyyy-mm-dd,yyyy-mm-dd (inclusive range) || upcoming || all
    app_id:"<YOUR_APP_ID>", //The application ID can be anything, but should be a word that describes your application or company.
}).then(function (_data) {
    //on success
}).catch(function (_data) {
    //on error
});

Get all parameters here

// all parameters: http://bandsintown.com/api/requests#artists-event-search
bandsintownFactory.getEventsFromArtistByLocation({
    artist:"<ARTIST_NAME>", // ? and / characters must be double escaped. Artists such as "AC/DC" will end up as "AC%252FDC"
    artist_id:"<ARTIST_ID>", // (optional) fallback: mbid_<id> (MusicBrainz ID), fbid_<id> (Facebook Page ID)
    date:"<DATE>", // (optional) (default: upcoming) yyyy-mm-dd || yyyy-mm-dd,yyyy-mm-dd (inclusive range) || upcoming || all
    location:"<LOCATION>", // city,state (US or CA) || city,country || lat,lon || ip address
    radius:"<RADIUS">, // (optional) (default: 25) in miles. valid values: 0-150
    app_id:"<YOUR_APP_ID>", //The application ID can be anything, but should be a word that describes your application or company.
}).then(function (_data) {
    //on success
}).catch(function (_data) {
    //on error
});

Get all parameters here

// all parameters: http://bandsintown.com/api/requests#artists-recommended-events
bandsintownFactory.getRecommendedEventsFromArtistByLocation({
    artist:"<ARTIST_NAME>", // ? and / characters must be double escaped. Artists such as "AC/DC" will end up as "AC%252FDC"
    artist_id:"<ARTIST_ID>", // (optional) fallback: mbid_<id> (MusicBrainz ID), fbid_<id> (Facebook Page ID)
    date:"<DATE>", // (optional) (default: upcoming) yyyy-mm-dd || yyyy-mm-dd,yyyy-mm-dd (inclusive range) || upcoming || all
    location:"<LOCATION>", // city,state (US or CA) || city,country || lat,lon || ip address
    radius:"<RADIUS">, // (optional) (default: 25) in miles. valid values: 0-150
    only_recs:"<ONLY_RECS>", // (optional) (default: false) if true, the response will only include matching events for artists similar to the specified artist. if false, the response may also include matching events for the specified artist.
    app_id:"<YOUR_APP_ID>", //The application ID can be anything, but should be a word that describes your application or company.
}).then(function (_data) {
    //on success
}).catch(function (_data) {
    //on error
});

Bandsintown V2 JSON API

Docs: http://bandsintown.com/api/requests

More angular-api-factories

bandsintown - dailymotion - facebook - flickr - footballdata - github - openweathermap - tumblr - vimeo - wikipedia - youtube

License

MIT