======Command http======

====Name====
**http** http client
  

====Synopsis====
http [options]

====Options====

===Requests===
||-get	url||	performs an HTTP GET||
||-put  url||	performs an HTTP PUT||
||-post	url||	performs an HTTP POST||
||-delete url||  performs an HTTP DELETE||
||-trace url|| 	performs an HTTP TRACE||
||-head url||	performs an HTTP HEAD||
||-options url|| performs an HTTP OPTIONS||

If no request options are supplied then -get is assumed.

===Connection Options===
||-connectTimeout time||	Sets the connection timeout||
||-contentType  content-type||	Sets the content type in the request property||
||-readTimeout	time||		Sets the read timeout||
||-useCaches,+useCaches||Turns on (off) caching||
||-followRedirects,+followRedirects||Turns on (off) redirection||
||-user username||		Authenticates with username||
||-password password||		Authenticates with password||
||-H,-add-header name=value|| Adds a HTTP header||
||-disableTrust protocol||Disables certificate trust validate for the specified procol||
||-keystore filename||Path to keystore for local client certificates||
||-keypass pass||Passphrase for keystore||
||-sslproto||Override the default (SSLv3) protocol for use when -keystore is used||


Time is specified in seconds, and can be fractional such as   2.5 

If username and password are both supplied then Basic Authentication is used.

For -put and -post the standard input is read and used as the input to the HTTP command.
For all commands the output of the HTTP command is sent to standard output.


====Examples====
%%(shell)
http -get http://www.xmlsh.org
%%
====Return Value====
Returns 0 if the is return code of the request is 200, otherwise returns the return code
----
[[Commands]]
[[CategoryCommands]]
[[CommandsExperimental]]