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)