How does SuiteAPI compare to SuiteTalk REST?

Unlike NetSuite's SuiteTalk REST Web service, SuiteAPI isn't RESTful. SuiteAPI is more of an RPC-style (short for "remote procedure call") Web API. All requests are made as HTTP POSTs, with JSON-encoded payloads. The response payloads are also JSON-encoded.

I have a SuiteQL query that runs in NetSuite (via the SuiteQL Query Tool), but it fails when I run it via SuiteAPI. Why?

Chances are that it's a permissions-related issue. The role that you're using in NetSuite is likely different from the role being used for the SuiteAPI integration, and therefore it has different permissions.

Review the role that you are using for the integration, and be sure that it has the permissions that you need.

Also, a potentially helpful resource for determining the permissions needed to access certain tables is available here: https://timdietrich.me/blog/netsuite-suiteql-tables-permissions-reference/

Does SuiteAPI support creating, updating, and/or deleting records?

In the current version of SuiteAPI, no standard procedures are included that support creating, updating, or deleting records. However, you could customize SuiteAPI to add support for those types of procedures.

In future versions of SuiteAPI, I will be adding support for and examples of those types of procedures.

What type of license is SuiteAPI being provided under?

SuiteAPI is being distributed under an MIT License.

The license is included in the SuiteAPI SuiteScript file.

When using SuiteAPI, should I be concerned about governance?

Governance can be a complicated subject. I recommend reading up on RESTlet Governance.

In general, the procedures that SuiteAPI supports are inexpensive in terms of "usage units." Being a RESTlet, SuiteAPI is allocated 5,000 usage units. It's unlikely that you'll hit that limit with a single SuiteAPI request.

You are more likely to encounter concurrency issues, where multiple requests are being processed concurrently - whether those requests are related to SuiteAPI, other NetSuite Web services (SuiteTalk, etc), or some combination. This "concurrency governance cheat sheet" can help explain how NetSuite handles concurrency: https://nlcorp.app.netsuite.com/core/media/media.nl?id=205292050&c=NLCORP&h=31f547d819de9e4473b2&_xt=.pdf