Send or retrieve data from a defined URI using HTTP.
Connector::Proxy::HTTP->new({
LOCATION => 'https://127.0.0.1/my/base/url',
});
See Connector::Role::SSLUserAgent for SSL and HTTP related
settings
- file/path
- The default behaviour is to append the list of given path arguments to
LOCATION as url path components "as is" by joining them with a
slash.
If you set file or path, the value is taken as a
template string, rendered and appended to LOCATION. In this case the
path arguments are NOT appended to the location but the. See
Connector::Role::LocalPath for details on the template part.
- query_param
- A HashRef, the key/value pairs are appended to the URI as query string.
Any values are escaped using uri_escape, keys are taken as is.
- A HashRef, the key/value pairs are set as HTTP headers.
- http_auth
- A HashRef with user and pass used as credentials to perform
a HTTP Basic Authentication.
- chomp_result
- When working with text documents the transport layer adds a trailing
newline which might be unhandy when working with scalar values. If set to
a true value, a trailing newline will be removed by calling
"chomp".
- undef_on_404
- By default, the connector will die if a resource is not found. If set to a
true value the connector returns undef, note that die_on_undef will be
obeyed.
- content
- A template toolkit string to generate the payload, receives the payload
argument as HasRef in DATA.
- content_type
- The Content-Type header to use, default is no header.
- http_method
- The http method to use, default is PUT.
If you need to parse the result returned by get, inherit from the
class an implement _parse_result. This method receives the response
object from the user agent call and must return a scalar value which is
returned to the caller.