usps-web-tools-node-sdk

    0.6.1 • Public • Published

    USPS Web Tools Node.js SDK

    A simple Node.js software developer's kit for the USPS Web Tools APIs.

    Installing

    npm install usps-web-tools-node-sdk
    

    Note: you might want to add the --save or --save-dev flag to add it to your package.json dependencies or devDependencies.

    Using

    Before you can use this SDK you'll need to get access to the USPS Web Tools via their registration process. Once complete you will receive an e-mail with your username and password and access to the:

    • Address APIs,
    • Tracking & Delivery Information APIs,
    • Price Calculator APIs, and
    • Service Standards & Commitments APIs.

    If you require access to the Shipping Label and Package Pickup APIs you'll need to request additional permissions as per the e-mail (see the II. Request Additional API Permissions section).

    // require the module
    var usps = require('usps-web-tools-node-sdk');
    
    // tell it to use your username from the e-mail
    usps.configure({ userID: 'YOUR_USERNAME' });
    
    // invoke the API you need with...
    usps.addressInformation.cityStateLookup(
      // a data object with the required fields
      { zipCode: ['90210'] },
      // and a callback
      function (error, response) {
        if (error) {
          // if there's a problem, the error object won't be null
          console.log(error);
        } else {
          // otherwise, you'll get a response object
          console.log(JSON.stringify(response));
        }
      }
    );
    

    Testing

    To run the tests:

    npm install
    npm test
    

    Contributing

    If you'd like to help just fork and pull.

    TODO

    The following still needs to get done:

    • Implement Shipping Label and Package Pickup APIs
    • Documentation
    • GitHub Pages
    • More tests (I ran in to a few instances where the Technical Documentation was wrong with regards to tag names, so tests that hit all the tags are needed)

    Install

    npm i usps-web-tools-node-sdk

    DownloadsWeekly Downloads

    325

    Version

    0.6.1

    License

    ISC

    Unpacked Size

    34.4 kB

    Total Files

    39

    Last publish

    Collaborators

    • dsusco