Post - Method

By using the inputs i_sHost (mandatory) and i_sResource the default header of the HTTP request is created. If additional information must be added to the header, they must be passed through the input i_anyAdditionalHeader. Data assigned to this input is not verified. At the input i_anyResponseBuffer, you must assign a buffer of sufficient size for storing the entire response received from the server.

The inputs i_anyContent and i_udiContentLength specify the content to be submitted.

The return value of the method is of type BOOL and indicates whether the execution of the method was successful (TRUE) or not (FALSE). Evaluate the diagnostic outputs of the method, in case the return value is FALSE. An error indicated by these outputs needs no reset. The property State must be used to obtain the status of processing.

A call of the method Post is allowed only in state Connected.

Following example shows how the HTTP request looks like after calling the method Post.

Method call:

sAdditionalHeader := 'Content-Type: application/json$r$nConnection: Keep-Alive';
sContent := 'This is the content!';

fbHTTP.Post(    i_sRessource:= 'example',
                i_sHost:= 'se.com',
                i_anyAdditionalHeader:= sAdditionalHeader,
                i_anyContent:= sContent,
                i_udiContentLength:= 20, 
                i_anyResponseBuffer:= sResponse);

Resulting HTTP request:

POST /example HTTP/1.1
Host: se.com
Content-Length: 20
Content-Type: application/json
Connection: Keep-Alive

This is the content!