HTTP Request Parameters in SuiteScript for NetSuite

The http.request method in SuiteScript enables developers to send HTTP requests. Understanding its parameters is essential for effective integration and interaction with external APIs.

How Does the HTTP Request Work?

The http.request method sends an HTTP request and the connection timeout settings are critical to note:

• The connection will time out if it exceeds 5 seconds.
• Request payloads must be completed within 45 seconds.

Keep in mind, this method is not usable in unauthenticated client-side contexts.

What Are the Supported Script Types?

This method can be utilized in both client and server scripts, making it versatile for different script types in the SuiteScript 2.x environment.

What Are the Governance Limits?

Each HTTP request operation consumes 10 governance units.

Parameters

The options parameter is required and must be a JavaScript object, containing the following fields:

What Errors Might Occur?

Several error codes can be returned to help diagnose issues when a request fails:

• SSS_INVALID_HOST_CERT: A certificate issue is detected.
• SSS_INVALID_URL: The specified URL is not fully qualified.
• SSS_MISSING_REQD_ARGUMENT: Required parameters (options.method or options.url) are missing.

Example Syntax

Here’s a basic example demonstrating how to structure an HTTP request using SuiteScript:

1var headerObj = {
2    name: 'Accept-Language',
3    value: 'en-us'
4};
5var response = http.request({
6    method: http.Method.GET,
7    url: 'http://www.google.com',
8    body: 'My REQUEST Data',
9    headers: headerObj
10});

This syntax allows for various configurations tailored to specific use cases by modifying the parameters provided.

Key Takeaways

• The HTTP request method requires specific parameters for functionality.
• Proper error handling is crucial for identifying issues related to requests.
• Governance units consumed during requests must be considered to avoid exceeding limits.