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)

Kaya                                                July 2013                                HTTP.postURL(3kaya)