Jsonrpc
is a simple JSON-RPC HTTP client built on Finch
It implements the JSON-RPC 2.0 specification
The package can be installed
by adding finch_jsonrpc
to your list of dependencies in mix.exs
:
def deps do
[
{:finch_jsonrpc, "~> 0.2.0"}
]
end
The docs can be found at https://hexdocs.pm/finch_jsonrpc.
Jsonrpc is preferably started under a Supervisor
. See Jsonrpc.start_link/1
for more information:
defmodule MyApp.Application do
use Application
def start(_type, _args) do
children = [
%{
id: Jsonrpc,
start: {Jsonrpc, :start_link, [name: :example]}
}
]
# See https://hexdocs.pm/elixir/Supervisor.html
# for other strategies and supported options
opts = [strategy: :one_for_one, name: MyApp.Supervisor]
Supervisor.start_link(children, opts)
end
end
Jsonrpc requests can be created using Jsonrpc.Request.new/1
and send using Jsonrpc.call/2
Jsonrpc.Request.new(method: "exampleMethod")
|> Jsonrpc.call(name: :example, url: "https://finchjsonrpc.redmaner.com)
Jsonrpc supports batch requests. When the request is a list of requests, a batch RPC call is made automatically.
See Jsonrpc.Request.new/2
on how to make batch requests.
Jsonrpc.Request.new(method: "exampleMethod")
|> Jsonrpc.Request.new(method: "exampleMethodTwo")
|> Jsonrpc.call(name: :example, url: "https://finchjsonrpc.redmaner.com)