Back to FabImage Studio website
You are here: Start » Filter Reference » System » HTTP » Http_SendRequest_GET
Module: | FoundationBasic |
---|
Sends a GET request to server and receives a text answer.
Name | Type | Range | Description | |
---|---|---|---|---|
![]() |
inUrl | String | URL of request. Without parameters. | |
![]() |
inFields | StringArray | Request data to send. It will be automatically encoded. | |
![]() |
inFieldsData | StringArray | Request data to send. It will be automatically encoded. | |
![]() |
inTimeout | Integer | 1 - ![]() |
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 GET request to the server. 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:
GET /test?param1=1¶m2=2 HTTP/1.1 Host: localhost User-Agent: FabImage/1.0 Accept: */*
Remarks
Filter only accepts text answers encoded using UTF-8 or plain ASCII. To receive answer in arbitrary format please use Http_SendRequest_GET_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_GET. |
DomainError | Empty inUrl in Http_SendRequest_GET. |
DomainError | Invalid inUrl in Http_SendRequest_GET. |
DomainError | Secured HTTPS connection is not supported Http_SendRequest_GET. |
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_GET filter group.
See Also
- Http_SendRequest_POST – Sends a POST request to the server and receives a text answer.
- Http_SendRequest_GET_ByteBuffer – Sends a GET request to server and receives a binary answer.