Requirements For Use
5.22 Engine or Higher
Available on any page, no item assignment required.
All parameters accept variables (g.url) or strings which must be wrapped in single quotes.
ACTION: Required, specifies the fully qualified URL to be contacted, starting with http.
METHOD: Required GET | POST | HEAD | XML | RAW | OPTIONS | PUT | DELETE | TRACE | CONNECT. In most cases use GET for simple page retrieval and use POST when when transmitting field data. If not specified and METHOD is XML, POST will have content type "text/xml." If not specified and METHOD is RAW, will have content type "text/plain.
CONTENT-TYPE: Optional, attribute available when the METHOD is XML or RAW.
The values of the variables listed in the FIELDS attribute will then be passed in the header.
FIELDS: Optional, comma delimited list of variables value pairs sent to the URL when POST is used as the method.
FILES: Optional, contains variables whose values are filenames that will be uploaded to the URL specified in ACTION.
CERTFILE: Optional, resolves to a location in the data directory containing a certificate or set of certificates.
CERTTYPE: Optional, must be either "PEM" or "ASN1".
CERTPASS: allows PEM-format certificates and/or private keys to be stored encrypted on disk. Ifspecified, the value of CERTPASS is used to decrypt the certificate and/or private key in the file specified by CERTFILE.
TIMEOUT: Optional, this value is used if it is smaller than the configured MvCONFIG_CALL_TIMEOUT value.
HEADERS: Optional, the value in this attribute will be placed after the Empresa-generated HTTP headers, but before the CRLF separating the HTTP headers and the body of the HTTP request.
PIN-ALGORITHM: [Requires 5.33 engine or above] Optional - PIN-ALGORITHM is either an empty string (which disables pinning), or an OpenSSL digest algorithm identifier, such as "sha1", "md5" or "sha256".
PIN-DIGEST: [Requires 5.33 engine or above] Optional - PIN-DIGEST is the binary "fingerprint" of the X509 certificate (as generated by X509_digest)
The ... loop terminates when the entire document has been received, or when an (optional) is encountered. If is encountered, processing start back at the top continuing with the next item.
This function returns the response a single object at a time in a system variable called s.callvalue. A common practice is to eval this variable within the loop which will display the entire result.
See this page for descriptions of all available system variables.