NetSuite - SuiteTalk REST Web Services


!Node.js CI    

Make requests to SuiteTalk REST Web Services

Installation

npm i netsuite-rest

Quick Start

To set up TBA in Netsuite, see the help topic Getting Started with Token-based Authentication.

var NsApiWrapper = require('netsuite-rest');
NsApi = new NsApiWrapper({
consumer_key: 'consumer_key',
consumer_secret_key: 'consumer_secret_key',
token: 'token',
token_secret: 'token_secret',
realm: 'realm'
//,base_url: 'base_url' // optional
});

Sample Requests

All requests are signed.

#### Test Request

NsApi.request({
path: '*',
method: "OPTIONS"
})
.then(response => console.log(response))
.catch((err) => console.log(err));

#### GET Request:

NsApi.request({
path: 'record/v1/customer/'
})
.then(response => response.data)
.then(data => console.log(data.links))
.catch((err) => console.log(err));

#### SuiteQL

> NOTE: If you are interested only in the SuiteQL, check SuiteQL package or view source code. SuiteQL class extends this class and can return promise or stream for large number of rows.

SuiteQL is a subservice of the query service. Following is an example to execute SuiteQL queries:

NsApi.request({
path: 'query/v1/suiteql?limit=5',
method: "POST",
body: {
"q":
"SELECT
id, companyName, email, dateCreated
FROM customer WHERE
dateCreated >= '01/01/2019'
AND dateCreated < '01/01/2020'"
}
})
.then(response => console.log(response))
.catch((err) => console.log(err));

Response

Requests are returned with promise support (.then(...)). HTTP response codes other than 2xx will cause the promise to be rejected.

Metadata

NsApi.request({path: 'record/v1/metadata-catalog/'})

Record is the name of the service we are trying to access, v1 is the service version, and metadata-catalog is the sub-resource, that is, the record metadata. The response informs you through HATEOAS links about the possible mediaType flavor in which the response can be obtained.

HATEOAS

You can navigate to the referenced resources without deeper knowledge of the system. A typical response contains "links" sections for each resource, which can be a sub-resource of a parent resource or any other referenced resource. You can use links to work with those resources.

More Resources

$3

Overview and Setup - Official Documentation

$3

REST API Browser provides a visual overview of the structure and capabilities of the REST web services Record API. The data presented in the REST API Browser is based on OpenAPI 3.0 metadata.