httppost
httppost |
Purpose
Synopsis
function httppost(url:string|text, data:string, result:string):integer
function httppost(url:string|text, data:string, result:string, xhdr:string|text):integer
Arguments
|
url
|
URL to process
|
|
data
|
Data file to be sent to the server
|
|
result
|
File to store the result of the request
|
|
xhdr
|
Additional headers to add to the request
|
Return value
HTTP status of the request (
e.g. 200 for success, see Section
Constants for a list of predefined status code constants; value 999 indicates that an I/O error occurred during the operation) or the request number (≥1000) if asynchronous mode is active
Further information
1. The function returns after the request has been processed when synchronous mode is active (see
http_async). Otherwise, using asynchronous mode, the function returns immediately after having sent the request and the model is notified about the completion of the operation by an event of class
EVENT_HTTPEND. In this mode the result file
result must be a physical file (although drivers
"tmp:" and
"null:" can still be used).
2. The parameter
xhdr is typically used when the data type has to be specified. For instance, when the data sent is URL-encoded it may be necessary to use
"Content-Type: application/x-www-form-urlencoded" as the value for
xhdr in order to indicate to the server how to decode and process the data.
3. By default the header
"Accept-Encoding: gzip" is inserted into the request and the result data is automatically decompressed if the server supports compression. This behaviour is disabled if this optional header is already specified (
e.g. the parameter
xhdr includes
"Accept-Encoding: identity").
4. When cookie management is enabled (see
http_cookies) an additional header
"Cookie:" is inserted into the request if the cookie store contains compatible cookies. This behaviour is disabled if this optional header is already specified via the parameter
xhdr.
Related topics
Module