SDK Elixir

def deps do
  [
    {:cpfhub, "~> 1.0"}
  ]
end

mix deps.get

# config/config.exs
config :cpfhub,
  api_key: System.get_env("CPFHUB_API_KEY"),
  timeout: 10_000  # ms, opcional

# config/runtime.exs
config :cpfhub,
  api_key: System.fetch_env!("CPFHUB_API_KEY")

case CPFHub.lookup("12345678909") do
  {:ok, data} ->
    IO.puts(data.name)    # "João da Silva"
    IO.puts(data.gender)  # "M"
  {:error, reason} ->
    IO.inspect(reason)
end

# Em caso de sucesso:
{:ok, %CPFHub.Data{
  cpf: "12345678909",
  name: "João da Silva",
  name_upper: "JOÃO DA SILVA",
  gender: "M",
  birth_date: "15/04/1985",
  day: 15,
  month: 4,
  year: 1985
}}

# Em caso de erro:
{:error, %CPFHub.Error{
  code: "CPF_NOT_FOUND",
  message: "CPF not found in our database",
  status_code: 404
}}

case CPFHub.lookup("12345678909") do
  {:ok, data} ->
    {:ok, %{name: data.name, gender: data.gender}}

  {:error, %CPFHub.Error{code: "CPF_NOT_FOUND"}} ->
    {:error, :not_found}

  {:error, %CPFHub.Error{code: "RATE_LIMIT_EXCEEDED"}} ->
    # aguardar e tentar novamente
    Process.sleep(1_000)
    CPFHub.lookup("12345678909")

  {:error, reason} ->
    {:error, reason}
end

defmodule MeuAppWeb.CPFController do
  use MeuAppWeb, :controller

  def show(conn, %{"cpf" => cpf}) do
    case CPFHub.lookup(cpf) do
      {:ok, data} ->
        json(conn, data)

      {:error, %CPFHub.Error{status_code: status, code: code}} ->
        conn
        |> put_status(status)
        |> json(%{error: code})
    end
  end
end

defmodule MeuApp.Accounts.User do
  use Ecto.Schema
  import Ecto.Changeset

  def changeset(user, attrs) do
    user
    |> cast(attrs, [:cpf, :email])
    |> validate_required([:cpf])
    |> validate_cpf_exists()
  end

  defp validate_cpf_exists(changeset) do
    case get_change(changeset, :cpf) do
      nil -> changeset
      cpf ->
        case CPFHub.lookup(cpf) do
          {:ok, _} -> changeset
          {:error, %CPFHub.Error{code: "CPF_NOT_FOUND"}} ->
            add_error(changeset, :cpf, "não encontrado na base de dados")
          _ -> changeset
        end
    end
  end
end