com.HttpRequest.beginJSONRequest

Starts a HTTP request streaming JSON.

Syntax

beginJSONRequest()
RETURNS json.JSONWriter

Usage

The beginJSONRequest() starts a streaming HTTP request and returns a JSONWriter object ready to send to the server.

Supported methods are: PUT, POST, PATCH, and DELETE.

Warning:

A message body is allowed in a DELETE request, but servers may ignore it if they do not support it.

The default Content-Type header is application/json.

In HTTP 1.1, if the body size is greater than 32 KB, the request will be sent in several chunks of the same size.

In case of error, the method throws an exception and sets the status variable. Depending on the error, a human-readable description of the problem is available in the sqlca.sqlerrm register. See Error handling in GWS calls (status).

The int_flag variable is checked during GWS API call to handle program interruptions, for more details, see Interruption handling in GWS calls (int_flag)