A promise based client for the Neto Ecommerce API.
npm i neto-api
Initialisation
Before you start making calls, you will need to initialise the API like so:
const{NetoAPI}=require("neto-api");
constmySite=newNetoAPI({
url:"https://myawesomesite.neto.com.au",
key:"api-key",
user:"user"// optional
});
This library can also be used with Neto's OAuth program by providing the oauth_clientId and oauth_secret configuration options instead of key. Here is an example:
constmySite=newNetoAPI({
url:"https://myawesomesite.neto.com.au",
oauth_clientId:"clientId",
oauth_secret:"secret"
});
Authentication
This library doesn't handle any authentication logic, it assumes that you already have obtained an API key or OAuth secret by some other means. More information on how to retrieve credentials can be found by visiting Neto's API documentation
Basic syntax
Once the library is initialised, you can use it like so:
mySite.type// See below for a list of supported types
.method()// See below for a list of methods for each type (generally add, get or update)
.exec()// Returns a promise that resolves with the API response in JSON format
.then(response)// Response object is returned via callback
.add() and .update() methods can be chained together with themselves to improve readability - the request itself will only be sent when .exec() is called. Check it out below:
mySite.item
.add({SKU:"smp_1"})
.add({SKU:"smp_2"})
.add({SKU:"smp_3"})
.exec()
.then(response=>{
console.log(response);
})
.catch(err=>console.log(err));
This allows you to some other cool stuff, such as building a bulk request to execute at some time in the future:
// Expose a copy of the request type
var addItems =api.item;
// Do some stuff...
addItems =addItems.add({SKU:"smp_1"});
// Do some other stuff...
addItems =addItems.add({SKU:"smp_2"});
// Keep building the request...
addItems =addItems.add({SKU:"smp_3"});
// Finally execute the request at a later time
addItems
.exec()
.then(response=>{
console.log(response);
})
.catch(err=>console.log(err));
Chaining .get() methods will be supported soon, I promise.
async/await support
Because this library is built on promises, it supports the use of async and await operators. Here's an example:
asyncfunctionaddItem(){
try{
var response =mySite.item.add({SKU:"smp_1"}).exec();