Popularity
4.2
Growing
Activity
5.9
Growing
35
2
2

Description

Find Brazilian addresses by zip code, directly from Correios database. No HTML parsers.

Monthly Downloads: 10
Programming language: Elixir
License: Apache License 2.0
Tags: Third Party APIs     API     Elixir    
Latest version: v0.7.0

Correios CEP alternatives and similar packages

Based on the "Third Party APIs" category

Do you think we are missing an alternative of Correios CEP or a related project?

Add another 'Third Party APIs' Package

README

Correios CEP

Hex.pm Docs Build Status Coverage Status [License](LICENSE)

Correios Logo

Find Brazilian addresses by postal code, directly from Correios API. No HTML parsers.

DEPRECATION NOTE

Correios.CEP.Address.zipcode was removed in the version 0.6.0. Use Correios.CEP.Address.postal_code instead.

Installation

The package can be installed by adding correios_cep to your list of dependencies in mix.exs:

def deps do
  [
    {:correios_cep, "~> 0.7.0"}
  ]
end

Usage

iex> Correios.CEP.find_address("54250610")
{:ok,
 %Correios.CEP.Address{
   street: "Rua Fernando Amorim",
   neighborhood: "Cavaleiro",
   complement: "",
   city: "Jaboatão dos Guararapes",
   state: "PE",
   postal_code: "54250610"
 }}

iex> Correios.CEP.find_address("00000-000")
{:error,
 %Correios.CEP.Error{
   type: :postal_code_not_found,
   message: "Postal code not found",
   reason: "CEP NAO ENCONTRADO"
 }}

iex> Correios.CEP.find_address!("54250-610")
%Correios.CEP.Address{
  street: "Rua Fernando Amorim",
  neighborhood: "Cavaleiro",
  complement: "",
  city: "Jaboatão dos Guararapes",
  state: "PE",
  postal_code: "54250610"
}

iex> Correios.CEP.find_address!("00000-000")
** (Correios.CEP.Error) Postal code not found

Options

There are some supported options that can be added to the request, as timeouts, proxy and URL configuration.

The example below shows the use of request_timeout and proxy options:

iex> Correios.CEP.find_address("54250610", request_timeout: 3000, proxy: {"localhost", 8888})
{:ok,
 %Correios.CEP.Address{
   street: "Rua Fernando Amorim",
   neighborhood: "Cavaleiro",
   complement: "",
   city: "Jaboatão dos Guararapes",
   state: "PE",
   postal_code: "54250610"
 }}

See Correios.CEP.find_address/2 documentation to check the details of the available options.

Documentation

The full documentation is available at https://hexdocs.pm/correios_cep.

Contributing

See the contributing guide.

License

Correios CEP is released under the Apache 2.0 License. See the LICENSE file.

Copyright © 2018-2020 Fernando Hamasaki de Amorim

Author

Fernando Hamasaki de Amorim (prodis)

Prodis Logo


*Note that all licence references and agreements mentioned in the Correios CEP README section above are relevant to that project's source code only.