NAME

       HTTP::getURL - Retrieve a URL by HTTP.

SYNOPSIS

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

ARGUMENTS

       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

       Retrieve 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 retrieving 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.parseURL (3kaya)
       HTTP.postURL (3kaya)