httpotion

v2.1.0

HTTPotion

The HTTP client for Elixir.

This module contains a basic general-purpose HTTP client. Everything in this module is created with use HTTPotion.Base. You can create your own customized client modules (see the README).

Summary

delete(url, options \\ [])

A shortcut for request(:delete, url, options)

get(url, options \\ [])

A shortcut for request(:get, url, options)

handle_response(response)
head(url, options \\ [])

A shortcut for request(:head, url, options)

options(url, options \\ [])

A shortcut for request(:options, url, options)

patch(url, options \\ [])

A shortcut for request(:patch, url, options)

post(url, options \\ [])

A shortcut for request(:post, url, options)

process_options(options)
process_request_body(body)
process_request_headers(headers)
process_response_body(body)
process_response_chunk(chunk)
process_response_headers(headers)
process_status_code(status_code)
process_url(url)
put(url, options \\ [])

A shortcut for request(:put, url, options)

request(method, url, options \\ [])

Sends an HTTP request

request(method, url, body, headers, options)

Deprecated form of request; body and headers are now options, see request/3

request_direct(conn_pid, method, url, body \\ "", headers \\ [], options \\ [])

Deprecated form of request with the direct option; body and headers are now options, see request/3

spawn_link_worker_process(url, options \\ [])

Starts a linked worker process for use with the direct option

spawn_worker_process(url, options \\ [])

Starts a worker process for use with the direct option

start()

Ensures that HTTPotion and its dependencies are started

stop_worker_process(pid)

Stops a worker process started with spawn_worker_process/2 or spawn_link_worker_process/2

transformer(target)

Functions

delete(url, options \\ [])

A shortcut for request(:delete, url, options).

get(url, options \\ [])

A shortcut for request(:get, url, options).

handle_response(response)
head(url, options \\ [])

A shortcut for request(:head, url, options).

options(url, options \\ [])

A shortcut for request(:options, url, options).

patch(url, options \\ [])

A shortcut for request(:patch, url, options).

post(url, options \\ [])

A shortcut for request(:post, url, options).

process_options(options)
process_request_body(body)
process_request_headers(headers)
process_response_body(body)
process_response_chunk(chunk)
process_response_headers(headers)
process_status_code(status_code)
process_url(url)
put(url, options \\ [])

A shortcut for request(:put, url, options).

request(method, url, options \\ [])

Specs

request(atom, String.t, Dict.t) ::
  %HTTPotion.Response{body: term, headers: term, status_code: term} |
  %HTTPotion.AsyncResponse{id: term}

Sends an HTTP request.

Args:

  • method - HTTP method, atom (:get, :head, :post, :put, :delete, etc.)
  • url - URL, binary string or char list
  • options - orddict of options

Options:

  • body - request body, binary string or char list
  • headers - HTTP headers, orddict (eg. ["Accept": "application/json"])
  • timeout - timeout in ms, integer
  • basic_auth - basic auth credentials (eg. {"user", "password"})
  • stream_to - if you want to make an async request, the pid of the process
  • direct - if you want to use ibrowse's direct feature, the pid of the worker spawned by spawn_worker_process/2 or spawn_link_worker_process/2

Returns HTTPotion.Response or HTTPotion.AsyncResponse if successful.
Raises HTTPotion.HTTPError if failed.

request(method, url, body, headers, options)

Deprecated form of request; body and headers are now options, see request/3.

request_direct(conn_pid, method, url, body \\ "", headers \\ [], options \\ [])

Deprecated form of request with the direct option; body and headers are now options, see request/3.

Starts a linked worker process for use with the direct option.

spawn_worker_process(url, options \\ [])

Starts a worker process for use with the direct option.

start()

Ensures that HTTPotion and its dependencies are started.

stop_worker_process(pid)

Stops a worker process started with spawn_worker_process/2 or spawn_link_worker_process/2.

transformer(target)