Fuel REST Client (for Node.js)
This repo used to be located at https://github.com/exacttarget/Fuel-Node-REST
This library allows users access to the Salesforce Marketing Cloud REST API at a low level.
Support
The Salesforce Marketing Cloud SDKs are community-supported projects. The SDK source code, samples, and documentation are publicly available on Github to use as-is or fork and modify for your needs. We invite everyone in the community to collaborate with us on Github and submit pull requests to help improve the source code and samples.
Installation
npm install fuel-rest --save
yarn add fuel-rest
Initialization
new FuelRest(options) - Initialization
options.auth
options.origin
or options.restEndpoint
options.headers
- Required: no
- Type:
Object
- set headers that apply to all REST requests (not auth requests)
options.globalReqOptions
- Required: no
- Type:
Object
- set configuration options that apply to all requests (auth + REST)
API
- apiRequest(options, callback)
options
- see request modules optionsoptions.auth
- will be passed into getAccessToken inside Fuel Authoptions.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.
- if no callback is passed, you'll need to use the promise interface
- get | post | put | patch | delete(options, callback)
options
- see apiRequest optionsoptions.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
const FuelRest = require('fuel-rest');
const options = {
auth: {
clientId: 'clientId',
clientSecret: 'clientSecret'
},
origin: 'https://alternate.rest.endpoint.com'
};
const RestClient = new FuelRest(options);
Examples
const options = {
uri: '/platform/v1/endpoints',
headers: {}
};
RestClient.get(options, (err, response) => {
if (err) {
console.log(err);
}
console.log(response);
});
RestClient.get(options)
.then(response => {
console.log(response);
})
.catch(err => console.log(err));
Contributors
Contributing
We welcome all contributions and issues! There's only one way to make this better, and that's by using it. If you would like to contribute, please checkout our guidelines!
Supported Node Versions
We follow the Node.js Release Schedule. When the current date is past the version's "Maintenance LTS End" it will no longer be supported by this library. A major release on this module will be published when this occurs.
ChangeLog
- See tags/release page for release notes after 0.7.2
- 0.7.2 - 2014-10-16 - account for content-type header not being present on API response
- 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