Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This server class

Tip

Change the REST_message_record text from the examples below to the record name of your REST message.

execute()

Sends the REST message.


Return:

TypeDescription
SimpleRestResponseResponse to the message sent by the execute() method.


Example:

Code Block
languagejs
themeEclipse
titleexecute
var sm = new sn_ws.SimpleRestRequestApi(“REST_message_record”, “get”);
var response = sm.execute();


setBasicAuth(userName, userPass)

Sets the username for web-service auth if the basic auth type was chosen. 


Parameter(s):

NameTypeMandatoryDefault Value
userNameStringYN
userPassStringYN


Return:

TypeDescription
VoidThis method does not return a value.


Example:

Code Block
languagejs
themeEclipse
titlesetBasicAuth
var sm = new sn_ws.SimpleRestRequestApi(“REST_message_record”, “get”);
sm.setBasicAuth(“username”, “password”);


setRequestUrl(requestUrl)

Sets the request URL.


Parameter(s):

NameTypeMandatoryDefault Value
requestUrlStringYN


Return:

TypeDescription
VoidThis method does not return a value.


Example:

Code Block
languagejs
themeEclipse
titlesetRequestUrl
var sm = new sn_ws.SimpleRestRequestApi(“REST_message_record”, “get”);
sm.setRequestUrl(“url”);


setRequestMethod(methodName)

Sets the requesting method (GET, POST, PURGE, etc). Accepts the requesting method name.


Parameter(s):

NameTypeMandatoryDefault Value
methodNameStringYN


Return:

TypeDescription
VoidThis method does not return a value.


Example:

Code Block
languagejs
themeEclipse
titlesetRequestMethod
var sm = new sn_ws . SimpleRestRequestApi(“REST_message_record”, “get”);
sm.setRequestMethod(“get”);


setRequestTimeout(timeout)

Sets the response timeout until the request is out of time.


Parameter(s):

NameTypeMandatoryDefault Value
timeoutIntegerYN


Return:

TypeDescription
VoidThis method does not return a value.


Example:

Code Block
languagejs
themeEclipse
titlesetRequestTimeout
var sm = new sn_ws . SimpleRestRequestApi(“REST_message_record”, “get”);
sm.setRequestTimeout(“60000”);



setQueryParameter(name, value)

Adds a parameter into the end of the request URL request formed generated as a "name=value",


Parameter(s):

NameTypeMandatoryDefault Value
nameStringYN
valueStringYN


Return:

TypeDescription
VoidThis method does not return a value.


Example:

Code Block
languagejs
themeEclipse
titlesetQueryParameter
var sm = new sn_ws . SimpleRestRequestApi(“REST_message_record”, “get”);
sm.setQueryParameter(“sysparm_query”, “active=true^ORDERBYDESCcategory”);


setRequestBody(body)

Sets the request body when used PUT or POST methods.


Parameter(s):

NameTypeMandatoryDefault Value
bodyStringYN


Return:

TypeDescription
VoidThis method does not return a value.


Example:

Code Block
languagejs
themeEclipse
titlesetRequestBody
var sm = new sn_ws . SimpleRestRequestApi(“REST_message_record”, “get”);
var body = “<Message body content>”;
sm.setRequestBody(body);


setStringParameter(name, value)

Sets the request variable with the name specified from the record to the value specified.


Parameter(s):

NameTypeMandatoryDefault Value
nameStringYN
valueStringYN


Return:

TypeDescription
VoidThis method does not return a value.


Example:

Code Block
languagejs
themeEclipse
titlesetStringParameter
var sm = new sws.RestRequest("<REST_request_record>","get"); 
sm.setStringParameter("s","NOW");


setRequestHeader(name, value)

Sets the HTTP header in the request for the value specified.


Parameter(s):

NameTypeMandatoryDefault Value
nameStringYN
valueStringYN


Return:

TypeDescription
VoidThis method does not return a value.


Example:

Code Block
languagejs
themeEclipse
titlesetRequestHeader
var sm = new sn_ws . SimpleRestRequestApi(“REST_message_record”, “get”);
sm.setRequestHeader(“Accept”, “Application/json”);



getRequestUrl()

Method description

Parameter(s):

NameTypeMandatoryDefault Value

Displays the request URL with parameters.


Return:

TypeDescription
StringThe request URl.


Example:

Code Block
languagejs
themeEclipse
titlegetRequestUrl
var sm = new sn_ws . SimpleRestRequestApi(“REST_message_record”, “get”);
var url = sm.getRequestUrl();


getRequestBody()

Returns the request body.


Return:

TypeDescription
StringThe request body.


Example:

Code Block

Method description

Parameter(s):

NameTypeMandatoryDefault Value
languagejs
themeEclipse
titlegetRequestBody
var sm = new sn_ws . SimpleRestRequestApi(“REST_message_record”, “get”);
var body = sm.getRequestBody();


getRequestHeaders()

Returns all the requested headers.


Return:

TypeDescription
ArrayThe requested headers.


Example:

Code Block

Method description

Parameter(s):

NameTypeMandatoryDefault Value
languagejs
themeEclipse
titlegetRequestHeaders
var sm = new sn_ws . SimpleRestRequestApi(“REST_message_record”, “get”);
var headers = sm.getRequestHeaders();


getRequestMethod()

Returns the requesting method


Return:

TypeDescription
StringThe method name


Example:

Code Block
languagejs
themeEclipse
titlegetRequestMethod
var sm = new sn_ws . SimpleRestRequestApi(“REST_message_record”, “get”);
var method = sm.getRequestMethod();


Table of Contents
absoluteUrltrue
classfixedPosition