.\" This man page is automatically generated using
.\" kayadoc2man from the Kaya development tools and the -xmldocs compile 
.\" option. Editing it directly is not encouraged.
.\" It is under the same license as the source .k file that it was
.\" generated from.
.TH "HTTP.postURL" "3kaya" "August 2014" "Kaya" "Kaya module reference"
.SH "NAME"
HTTP::postURL \- Post data to a URL by HTTP.
.SH "SYNOPSIS"
.B String postURL(
\fIString post, HTTPURL url, [Pair<String, String> ] headers=createArray(1), HTTPversion version=HTTP10, [String] certfiles=[]\fP
.B ")"
.SH "ARGUMENTS"
.PP
.B "post"
The data to post, encoded as application/x-www-form-urlencoded data
.PP
.B "url"
A
.B "HTTP.HTTPURL"(3kaya)

.PP
.B "headers"
A list of key/value pairs of extra HTTP headers (optional, defaulting to the empty list)
.PP
.B "version"
The HTTP version
.PP
.B "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.
.SH "DESCRIPTION"
.PP
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.
.SH "AUTHORS"
Kaya standard library by Edwin Brady, Chris Morris and others (kaya@kayalang.org). For further information see http://kayalang.org/
.SH 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.
.SH "RELATED"
.PD 0
.PP
.B "HTTP.basicAuthHeader"(3kaya)
.PP
.B "HTTP.getURL"(3kaya)
.PP
.B "HTTP.parseURL"(3kaya)
.PD 0.4v