Result$ = GetHTTPHeader(URL$ [, Flags [, UserAgent$]])
Get the HTTP headers of the given URL.
This function is deprecated, it may be removed in a future version of PureBasic. It should not be used in newly written code.

Note: This function has been replaced by HTTPRequest(). Use that instead.


URL$ The URL for the query. The URL must be fully qualified, and must include the "http://" or "https://" prefix.
Flags (optional) It can be one of the following value:
  #PB_HTTP_NoRedirect: don't follow automatic redirections.
UserAgent$ (optional) Change the user agent for the HTTP request. Default user agent is set to "Mozilla/5.0 Gecko/41.0 Firefox/41.0" for maximum compatibility.

Return value

Returns a string containing the header lines. Each line ends with a Chr(10) character. StringField() can be used to split it into several strings.

The content of the headers are dependent on the type of server and therefore their contents vary, but the header that is returned by that server, provides very useful information about the file, such as the date, the server type, the version, and more.


InitNetwork() has to be called before using this command.

On Linux, 'libcurl' needs to be installed to have this command working (most of Linux distributions comes with it already installed).



  Header$ = GetHTTPHeader("")

    Line$ = StringField(Header$, Index, #LF$)
    Debug Line$
  Until Line$ = ""
Example of returned headers:
  HTTP/1.1 200 OK
  Date: Fri, 21 Mar 2008 09:49:30 GMT
  Server: Apache/1.3.34 (Debian) mod_vhost_online/1.1 mod_fastcgi/2.4.2 mod_log_online/0.1
  X-Powered-By: PHP/4.4.8-1
  Content-Type: text/html

See Also

ReceiveHTTPFile(), URLEncoder()

Supported OS


<- FinishHTTP() - Http Index - GetURLPart() ->