mirror of
https://github.com/rest-client/rest-client.git
synced 2022-11-09 13:49:40 -05:00
Add docs to the README about cookies & proxies.
This commit is contained in:
parent
7928152945
commit
4f1bc2109b
1 changed files with 23 additions and 0 deletions
23
README.rdoc
23
README.rdoc
|
@ -304,6 +304,20 @@ use whatever proxy the system is configured to use:
|
||||||
|
|
||||||
RestClient.proxy = ENV['http_proxy']
|
RestClient.proxy = ENV['http_proxy']
|
||||||
|
|
||||||
|
<b>New in 2.0:</b> Specify a per-request proxy by passing the :proxy option to
|
||||||
|
RestClient::Request. This will override any proxies set by environment variable
|
||||||
|
or by the global RestClient.proxy value.
|
||||||
|
|
||||||
|
RestClient::Request.execute(method: :get, url: 'http://example.com',
|
||||||
|
proxy: 'http://proxy.example.com')
|
||||||
|
# => single request proxied through the proxy
|
||||||
|
|
||||||
|
This can be used to disable the use of a proxy for a particular request.
|
||||||
|
|
||||||
|
RestClient.proxy = "http://proxy.example.com/"
|
||||||
|
RestClient::Request.execute(method: :get, url: 'http://example.com', proxy: nil)
|
||||||
|
# => single request sent without a proxy
|
||||||
|
|
||||||
== Query parameters
|
== Query parameters
|
||||||
|
|
||||||
Request objects know about query parameters and will automatically add them to
|
Request objects know about query parameters and will automatically add them to
|
||||||
|
@ -342,6 +356,15 @@ extract and set headers for them as needed:
|
||||||
)
|
)
|
||||||
# ...response body
|
# ...response body
|
||||||
|
|
||||||
|
=== Full cookie jar support (new in 1.8)
|
||||||
|
|
||||||
|
The original cookie implementation was very naive and ignored most of the
|
||||||
|
cookie RFC standards.
|
||||||
|
<em>New in 1.8</em>: An HTTP::CookieJar of cookies
|
||||||
|
|
||||||
|
Response objects now carry a cookie_jar method that exposes an HTTP::CookieJar
|
||||||
|
of cookies, which supports full standards compliant behavior.
|
||||||
|
|
||||||
== SSL/TLS support
|
== SSL/TLS support
|
||||||
|
|
||||||
Various options are supported for configuring rest-client's TLS settings. By
|
Various options are supported for configuring rest-client's TLS settings. By
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue