Back to FabImage Studio website

You are here: Start » Filter Reference » System » HTTP » Http_SendRequest_POST_JSON

Http_SendRequest_POST_JSON

Basic

Module: FoundationBasic

Sends a POST request in JSON format to the server and receives a text answer.

Name Type Range Description
Input value
 inUrl String URL of request.
Input value
 inJsonData String Request JSON to send.
Input value
 inTimeout Integer 0 - Request timeout in seconds.
Output value
 outAnswer String? Answer text if provided in UTF-8 encoding.
Output value
 outResponseCode Integer Answer code. Typically 200 for OK.

Description

Filter sends a POST request to the server using application/json format. Filter waits for the text sever answer.

Examples

Filter executed with parameters:

  • inUrl = http://localhost/test
  • inJsonData = "{'value': 5}"

Request sent to the server:

POST /test HTTP/1.1
Host: localhost
User-Agent: FabImage/1.0
Accept: application/json
Content-Type: application/json
charset: utf-8
Content-Length: 12

{'value': 5}

Remarks

Filter only accepts text answers encoded using UTF-8 or plain ASCII.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Empty inUrl in Http_SendRequest_POST_JSON.
DomainError Invalid inUrl in Http_SendRequest_POST_JSON.
DomainError Secured HTTPS connection is not supported Http_SendRequest_POST_JSON.

Complexity Level

This filter is available on Basic Complexity Level.

Disabled in Lite Edition

This filter is disabled in Lite Edition. It is available only in full, FabImage Studio Professional version.

Filter Group

This filter is member of Http_SendRequest_POST filter group.

See Also