Start » Filter Reference » System » HTTP » Http_SendRequest_POST
Module: | FoundationBasic |
---|
Sends a POST request to the server and receives a text answer.
Name | Type | Range | Description | |
---|---|---|---|---|
![]() |
inUrl | String | URL of request. | |
![]() |
inFields | StringArray | Request data to send. It will be automatically encoded. | |
![]() |
inFieldsData | StringArray | Request data to send. It will be automatically encoded. | |
![]() |
inTimeout | Integer | 0 - ![]() |
Request timeout in seconds. |
![]() |
outAnswer | String? | Answer text if provided in UTF-8 encoding. | |
![]() |
outResponseCode | Integer | Answer code. Typically 200 for OK. |
Description
Filter sends a POST request to the server using application/x-www-form-urlencoded format. Filter waits for the sever text answer.
Examples
Filter executed with parameters:
- inUrl = http://localhost/test
- inFields = ["param1", "param2"]
- inFieldsData = ["1", "2"]
Request sent to the server:
POST /test HTTP/1.1 Host: localhost User-Agent: Aurora Vision/1.0 Accept: */* Content-Length: 17 Content-Type: application/x-www-form-urlencoded param1=1¶m2=2
Remarks
Filter only accepts text answers encoded using UTF-8 or plain ASCII. To receive answer in arbitrary format please use Http_SendRequest_POST_ByteBuffer.
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 | Different size of inFields and inFieldsData in Http_SendRequest_POST. |
DomainError | Empty inUrl in Http_SendRequest_POST. |
DomainError | Invalid inUrl in Http_SendRequest_POST. |
DomainError | Secured HTTPS connection is not supported in Http_SendRequest_POST. |
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, Aurora Vision Studio Professional version.
Filter Group
This filter is member of Http_SendRequest_POST filter group.
See Also
- Http_SendRequest_POST_JSON – Sends a POST request in JSON format to the server and receives a text answer.
- Http_SendRequest_POST_ByteBuffer – Sends a POST request to the server and receives a text answer.