ApiBrasil.Data.Correios (APIBrasil v0.0.1)

Copy Markdown View Source

Correios (device-based): POST /correios/{action}.

Além das funções nomeadas, request/4 aceita qualquer action do catálogo e queue/4 executa a mesma action por fila.

{:ok, envelope} = ApiBrasil.Data.Correios.rastreio(client, %{"code" => "AA123456789BR"})
ApiBrasil.Core.DeviceResponse.response(envelope)

Summary

Functions

Executa a action de forma assíncrona, por fila: POST /correios/{action}/queue.

Rastreia uma encomenda: POST /correios/rastreio.

Como rastreio/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

Executa qualquer action do serviço: POST /correios/{action}.

Serviço do gateway coberto por este módulo: correios.

Types

result()

@type result() :: {:ok, map()} | {:error, ApiBrasil.Core.Error.t()}

Functions

queue(client, action_name, body \\ nil, opts \\ [])

Executa a action de forma assíncrona, por fila: POST /correios/{action}/queue.

queue!(client, action_name, body \\ nil, opts \\ [])

Como queue/4, mas levanta ApiBrasil.Core.Error em caso de falha.

rastreio(client, body \\ nil, opts \\ [])

@spec rastreio(ApiBrasil.Client.t(), term(), keyword()) ::
  {:ok, ApiBrasil.Core.DeviceResponse.t()} | {:error, ApiBrasil.Core.Error.t()}

Rastreia uma encomenda: POST /correios/rastreio.

rastreio!(client, body \\ nil, opts \\ [])

Como rastreio/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

request(client, action_name, body \\ nil, opts \\ [])

Executa qualquer action do serviço: POST /correios/{action}.

As actions conhecidas estão em ApiBrasil.Generated.Catalog.service_actions("correios"); a documentação completa fica em https://doc.apibrasil.io.

request!(client, action_name, body \\ nil, opts \\ [])

Como request/4, mas levanta ApiBrasil.Core.Error em caso de falha.

service()

@spec service() :: String.t()

Serviço do gateway coberto por este módulo: correios.