HTTP Header Management in SuiteScript for NetSuite

HTTP headers are crucial for transmitting additional information in HTTP requests and responses. Each header consists of a case-insensitive name followed by a colon (:) and its value, without line breaks. When working with custom headers in SuiteScript, it is important to ensure that header names do not contain underscores.

Understanding Blocked HTTP Headers

Certain HTTP headers are restricted in NetSuite, particularly when using the N/http module methods. If a script attempts to modify these headers, the values will be ignored. The following general headers are blocked:

Suitelet Response HTTP Header Restrictions

In addition to the general blocked headers, some headers are also restricted when dealing with http.ServerResponse objects in Suitelets. Scripts attempting to set these headers will trigger an SSS_INVALID_HEADER error. The restricted headers include:

Code Sample

Understanding how to manage headers is essential for effective communication with NetSuite's APIs. Below is a sample of how to add headers in SuiteScript:

// Sample code snippet to add a header
serverResponse.addHeader({
    name: 'Accept-Language',
    value: 'en-us',
});

Key Considerations

• Custom Headers: Avoid underscores in the names of custom headers.
• Script Errors: Be mindful of the headers that trigger errors to ensure robust script execution.

By following these practices, you can effectively manage HTTP headers in your SuiteScript applications, ensuring compliance with NetSuite's handling of HTTP communication.

Source: This article is based on Oracle's official NetSuite documentation.