HTTP Method Errors in SuiteScript N/http Module

The SuiteScript N/http module provides a way to make HTTP calls within NetSuite scripts. Understanding how errors are handled when dealing with HTTP methods is crucial for developers to avoid common pitfalls and ensure smooth operation of their scripts.

What Error Codes Can Occur?

When using the N/http module, developers may encounter specific error codes, particularly related to HTTP methods. The primary error you might encounter is:

• Error Code: READ_ONLY_PROPERTY
  • Thrown If: You attempted to edit a property that is designated as read-only.

Example Usage of HTTP Methods

The N/http module supports several HTTP methods, which include:

• DELETE
• GET
• HEAD
• PUT
• POST
• PATCH

Here's a snippet showcasing how you might use the N/http module in a script:

// Example of logging the server request method
log.debug({
    title: 'Server Request Method',
    details: request.method
});

Important Considerations

Be aware that the N/http module is tailored for HTTP calls but does not accept the HTTPS protocol. For secure connections, you should utilize the N/https module.

Blocked HTTP Headers

When working with the N/http module, certain HTTP headers cannot be modified and will not be set in your requests. These blocked headers include:

• Connection
• Content-Length
• Host
• JSESSIONID
• Trailer
• Transfer-Encoding
• Upgrade
• Via

This restriction is important to note as it ensures that your script does not attempt to set unsupported headers, which would lead to discarded values and potentially unexpected behavior.

Who This Affects

This information primarily affects developers working with:

• SuiteScript
• Custom integrations
• HTTP API calls within the NetSuite platform

Key Takeaways

• The N/http module allows for HTTP requests but has some read-only properties.
• Attempting to modify these properties results in a READ_ONLY_PROPERTY error.
• Be mindful of blocked HTTP headers when crafting requests.
• Use the corresponding N/https module for secure HTTPS calls.
• Understanding error codes helps in debugging scripts effectively.

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