tweettypography/Fuel-Node-REST

Node REST client to access ExactTarget's API

Fuel REST Client (for Node.js)

This library allows users access to ExactTarget's REST API at a low level.

Initialization

new FuelRest( options ) - Initialization

• options.auth
  • Required: yes
  • Type: Object or FuelAuth Instance
  • properties need to match FuelAuth
• options.origin or options.restEndpoint
  • Required: no
  • Type: String
  • Default: https://www.exacttargetapis.com

API

• apiRequest( options, callback )
  • options - see request modules options
  • options.auth - will be passed into getAccessToken inside Fuel Auth
  • options.uri - can either be a full url or a path that is appended to options.origin used at initialization (url.resolve)
  • options.retry - boolean value representing whether or not to retry request (and request new token) on 401 invalid token response. default: false
  • callback - executed after task is completed. required
• get | post | put | patch | delete( options, callback )
  • options - see apiRequest options
  • options.retry - see above for description. default: true
  • callback - see apiRequest options
  • Request method will be overwritten by these methods. It will be set to same value as the name of the method used

Setting up the client

var FuelRest = require( 'fuel-rest' );
var options  = {
    auth: {
        // options you want passed when Fuel Auth is initialized
        clientId: 'clientId'
        , clientSecret: 'clientSecret'
    }
    , origin: 'https://alternate.rest.endpoint.com' // default --> https://www.exacttargetapis.com
};

var RestClient = new FuelRest( options );

Examples

var options = {
    uri: '/platform/v1/endpoints'
    headers: {}
    // other request options
};

RestClient.get( options, function( err, response ) {
    if( err ) {
        // error here
        console.log( error );
    }

    // will be delivered with 200, 400, 401, 500, etc status codes
    // response.body === payload from response
    // response.res === full response from request client
    console.log( response );
});

ChangeLog

• 0.7.1 - 2014-09-09 - removed unneeded "!!"
• 0.7.0 - 2014-08-29 (public release, 1st npm version)
  • request retry on 401 invalid token response
  • created helpers file for certain functions
  • updated error delivering/throwing
• 0.6.0 - 2014-08-26 - added patch method
• 0.5.0 - 2014-08-26 - API overhaul (apiRequest + all http methods) - breaking
• 0.4.0 - 2014-08-25 - changed object initialization - breaking
• 0.3.0 - 2014-08-20
  • added ability to use initialized fuel auth
  • updated travis ci config
  • added license
• 0.2.0 - 2014-08-09 - removed event emitter - breaking
• 0.1.0 - 2014-08-07
  • initial module
  • initial unit tests