Back to FabImage Library website

You are here: Start » Function Reference » HTTP » Http_SendRequest_POST_Raw

Http_SendRequest_POST_Raw


Header:FIL.h
Namespace:fil

Sends a POST request to the server and receives an answer.

Syntax

C++
C#
 
void fil::Http_SendRequest_POST_Raw
(
	const ftl::String& inUrl,
	const ftl::Array<ftl::String>& inFields,
	const ftl::Array<ftl::String>& inFieldsData,
	ftl::Conditional<ftl::String>& outAnswer,
	int& outResponseCode
)

Parameters

Name Type Default Description
inUrl const String& Url of request.
inFields const Array<String>& Request data to send. It will be automatically encoded.
inFieldsData const Array<String>& Request data to send. It will be automatically encoded.
outAnswer Conditional<String>& Answer text if provided in UTF-8 encoding.
outResponseCode int& 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: FabImage/1.0
Accept: */*
Content-Length: 17
Content-Type: application/x-www-form-urlencoded

param1=1&param2=2

Errors

List of possible exceptions:

Error type Description
DomainError Different size of inFields and inFieldsData.

See Also