Scroll to navigation

HTTP.postURL(3kaya) Kaya module reference HTTP.postURL(3kaya)

NAME

HTTP::postURL - Post data to a URL by HTTP.

SYNOPSIS

String postURL( String post, HTTPURL url, [Pair<String, String> ] headers=createArray(1), HTTPversion version=HTTP10, [String] certfiles=[] )

ARGUMENTS

post The data to post, encoded as application/x-www-form-urlencoded data
url A HTTP.HTTPURL (3kaya)
headers A list of key/value pairs of extra HTTP headers (optional, defaulting to the empty list)
version The HTTP version
certfiles A list of SSL certificate files, each containing one or more PEM encoded certificates of trusted Certification Authorities, used for HTTPS connections. This list may be empty (the default), but this is much less secure. For HTTP connections, this parameter is ignored.

DESCRIPTION

Post data to a URL by HTTP. The String returned will contain the HTTP response headers and response body exactly as sent by the server. Because Strings may not contain null bytes, this function is not suitable for requests that may return binary data.

AUTHORS

Kaya standard library by Edwin Brady, Chris Morris and others (kaya@kayalang.org). For further information see http://kayalang.org/

LICENSE

The Kaya standard library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (version 2.1 or any later version) as published by the Free Software Foundation.

RELATED

HTTP.basicAuthHeader (3kaya)
HTTP.getURL (3kaya)
HTTP.parseURL (3kaya)
August 2014 Kaya