Behaviour for the HTTP transport used by TreasuryPrime.Client.

TreasuryPrime ships with a zero-dependency default adapter (TreasuryPrime.HTTPClient.Httpc) built on Erlang's :httpc, so the library works out of the box without pulling in Req, Finch, Hackney, or any other HTTP stack. If your application already depends on one of those (very likely, since most production apps do), you can plug it in instead by implementing this behaviour and passing http_client: YourAdapter to TreasuryPrime.Client.new/1.

Writing your own adapter

defmodule MyApp.ReqAdapter do
  @behaviour TreasuryPrime.HTTPClient

  @impl true
  def request(method, url, headers, body, opts) do
    case Req.request(method: method, url: url, headers: headers, body: body,
                      receive_timeout: Keyword.get(opts, :receive_timeout, 30_000),
                      retry: false) do
      {:ok, resp} -> {:ok, %{status: resp.status, headers: resp.headers, body: resp.body}}
      {:error, reason} -> {:error, reason}
    end
  end
end

TreasuryPrime.Client.new(api_key_id: "...", api_key_value: "...", http_client: MyApp.ReqAdapter)