module function · N/https

request()

https.request(options)

Sends an HTTPS request and returns the response.

Implementation
Not started
Design
Open for proposals suggest how it should read
Proposals
A
Signature
https.request(options)
Module
N/https
Returns
https.ClientResponse or https.ServerResponse
Governance
10 units
Script types
Client and server scripts
Version
SuiteScript 2.x, documented for 2.1; since NetSuite 2015.2
call shapefrom Oracle's parameter table
1https.request({2    method:      /* enum, required */,3    url:         /* string, required */,4    body:        /* string | Object, optional */,5    credentials: /* string[], optional */,6    headers:     /* Object, optional */7});
Oracle reference for this method
ParameterTypeRequiredDescription
options.methodenumrequiredThe HTTPS request method. Use https.Method to set this value.
options.urlstringrequiredThe HTTPS URL being requested.
options.bodystring | ObjectoptionalThe body content to send in the HTTPS request. Only the PUT, POST, and PATCH https.Method values support this parameter; all other methods ignore it.
options.credentialsstring[]optionalAn array of string GUIDs. These GUIDS are searched for in the options.body of the request and are replaced by the decrypted passwords before they are sent to a third-party server.
options.headersObjectoptionalThe HTTPS headers. For more information, see HTTPS Header Information .
B

No Mynt syntax yet.

Nothing in the language compiles to https.request(options) today. How should it read?

C

Competing syntax for request, from GitHub Discussions. Select two or more to compare them side by side.

All discussions

Loading proposals from GitHub…

D

Write the Mynt you wish you could write.

A good proposal shows the syntax, the SuiteScript it should become, and argues for it: why it is clearer, how it fits the rest of the language, what it makes harder.

  • Clarity. Does it say what happens, without ceremony?
  • Consistency. Does it read like load, save and Ref[field]?
  • Expressiveness. Does it cover the cases people actually write?
  • Honesty. Does it hide a NetSuite cost, such as governance, that a reader should see?

N/https · https.request(options)

Suggest syntax for request