#address #cep #api #brasil #localization #correios

rbytes_consulta_cep

Consulta de CEP brasileiro com multi-provedores (ViaCEP, BrasilAPI, etc). Inclui fallback automático, timeout configurável e formatação de endereços.

1 unstable release

new 0.1.0 Apr 27, 2025

#200 in Internationalization (i18n)

MIT license

20KB
393 lines

RBytesConsultaCEP

Biblioteca Rust para consulta de CEPs brasileiros com:

✅ Suporte a múltiplos provedores (BrasilAPI, ViaCEP, OpenCEP e ApiCEP)
✅ Validação de formato de CEP
✅ Tipagem forte e tratamento de erros detalhado
✅ fallback automático, entre varios provedores

Como usar

[dependencies]
rbytes-consulta-cep = { git = "https://github.com/rodrigodelphino/RBytesConsultaCEP" }

---

## 📦 Instalação

Adicione ao seu `Cargo.toml`:

```toml
[dependencies]
rbytes_consulta_cep = "0.1.0"

---

## 🚀 Uso Básico

use rbytes_consulta_cep::consultar;

#[tokio::main]
async fn main() {
    match consultar("01001000").await {
        Ok(endereco) => println!("{}", endereco),
        Err(e) => eprintln!("Erro: {}", e),
    }
}

---

## 🔍 Provedores Suportados

ViaCEP (https://viacep.com.br)
BrasilAPI (https://brasilapi.com.br)
ApiCEP (https://apicep.com)
OpenCEP (https://opencep.com)

A biblioteca tenta cada provedor na ordem padrão até obter uma resposta válida.

---

## 🤝 Contribuição

Pull requests são bem-vindos! Sinta-se à vontade para abrir issues, reportar bugs ou sugerir melhorias. Este projeto visa ser simples e acessível para toda a comunidade .NET.

---
Por Rodrigo Delphino - [github.com/rodrigodelphino](https://github.com/rodrigodelphino)

Dependencies

~9–23MB
~315K SLoC