Neocon Propaganda Machine
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    hapinesspublic

    SmugMug hAPIness

    The hAPIness function wraps the complexities of creating valid and usable URLs for requests to the Smugmug API by requiring only the necessary information and allows for dependancy injection if desired for easier use.

    AN API is great for providing access to data but interacting with one is not something that is fun for us humans.

    Dependancies

    NONE! Well, JavaScript.

    The library doesn't have any external dependancies; this does also mean that it doesn't actually do any ajax requests for you or parameter string creation, you'll need to provide that based on your library of choice.

    Usage

    First, you will need to include the hAPIness.js file in you project somehow."

    Browser Environments

    <script src="hAPIness.js"></script>
    // or using a script loader, such as RequireJS

    Using jQuery for AJAX and parameterization.

    // use smugmug as the variable name to make you code fit the
    // API methods SmugMug provides; e.g. smugmug.albums.get()
    var smugmug = hAPIness("myAPIkey", "1.3.0");
     
    // this gives hAPIness the ability to fully create URLs for you
    hAPIness.setParamFn($.param);
     
    smugmug.service.ping();
    // returns
    // http://api.smugmug.com/services/api/json/1.3.0/?method=smugmug.service.ping&APIKey=myAPIkey&Callback=
     
    // now hAPIness can create URLs for you to use in ajax calls
    $.ajax({
      dataType: "jsonp"
      ,success: function (data) {
        // data.Albums is an array of all user's albums
      })
      ,url: smugmug.albums.get({NickName: "SmugMug_username"})
    });

    NodeJS Environments

    First include the package in the project from npm.

    $ npm install hapiness

    Then use the library in your project

    var hAPIness = require("hAPIness")
      , qs = require("qs");
     
    // use smugmug as the variable name to make you code fit the
    // API methods SmugMug provides; e.g. smugmug.albums.get()
    var smugmug = hAPIness("myAPIkey", "1.3.0");
     
    // this gives hAPIness the ability to fully create URLs for you
    hAPIness.setParamFn(qs.stringify);
     
    smugmug.service.ping();
    // returns
    // http://api.smugmug.com/services/api/json/1.2.2/?method=smugmug.service.ping&APIKey=myAPIkey&JSONCallback=?

    Keywords

    none

    install

    npm i hapiness

    Downloadsweekly downloads

    8

    version

    0.5.1

    license

    none

    repository

    githubgithub

    last publish

    collaborators

    • avatar