RESTlets vs. Other NetSuite Integration Options
RESTlets provide one option for integration with NetSuite. Other options include SOAP-based web services, REST web services, and Suitelets.
For a comparison of RESTlets with REST web services, see REST Web Services and Other Integration Options.
The concurrency limits that apply to SOAP and REST web services and RESTlets are unified. For information about concurrency governance, see Web Services and RESTlet Concurrency Governance.
RESTlets Compared to SuiteTalk Web Services
The following table compares the characteristics of RESTlets with those of SOAP and REST web services:
|
Attribute |
RESTlets |
SOAP web services |
REST web services |
|---|---|---|---|
|
Supported Functionality |
For a list of supported functionality, see SuiteScript 2.x RESTlet Script Type. |
For a list of supported functionality, see SOAP Web Services Operations. |
For a list of supported functionality, see Overview of SuiteTalk REST Web Services. |
|
Supported Authentication Method |
User credentials, token-based authentication, OAuth 2.0
Important:
You can't use user credentials to authenticate new RESTlets. If you try, you'll get an HTTP error. For more information, see Using User Credentials for RESTlet Authentication. |
User credentials, token-based authentication
Important:
Don't use user credentials for SOAP web services authentication. If you're currently using this method, use token-based authentication instead. As of the 2020.2 SOAP web services endpoint, you can't use request-level credentials for authentication. This doesn't affect web services integrations using 2020.1 or earlier endpoints. |
Token-based authentication, OAuth 2.0 |
|
Supported Content Types |
JSON, text/xml |
text/xml |
Standard content types: JSON, OpenAPI 3.0 |
|
Environment |
More suitable for low bandwidth use cases, programmable endpoint that needs deployment. |
Usually a client-side SOAP framework or library is used. No coding and script deployment needed on the server side. |
No coding and script deployment needed on the server side, suitable for low bandwidth use cases. |
|
Performance |
You can create a RESTlet to handle all actions for a business flow in one call. RESTlets can be tailored for a specific need and are highly efficient. |
SOAP web services may require more calls to accomplish a business flow. |
The performance of SuiteTalk REST and SuiteTalk SOAP operations is similar. The performance can differ slightly depending on the specific use case. For example, REST may need fewer calls to accomplish a business flow than SOAP. REST web services also support technology that is not supported in SOAP, for example, SuiteQL. |
Use SOAP web services for system-to-system integrations.