PHPackages                             kamoca/fallback-cep-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. kamoca/fallback-cep-api

ActiveLibrary[API Development](/categories/api)

kamoca/fallback-cep-api
=======================

Fallback de chamadas para múltiplas APIs de CEP

v1.2.0(10mo ago)0162↓85%MITPHPPHP ^8.2

Since Jul 22Pushed 10mo ago1 watchersCompare

[ Source](https://github.com/KauanCalheiro/fallback-cep-api)[ Packagist](https://packagist.org/packages/kamoca/fallback-cep-api)[ Docs](https://github.com/KauanCalheiro/fallback-cep-api)[ RSS](/packages/kamoca-fallback-cep-api/feed)WikiDiscussions main Synced yesterday

READMEChangelog (3)Dependencies (1)Versions (4)Used By (0)

📍 Kamoca/FallbackCepApi
=======================

[](#-kamocafallbackcepapi)

[![Latest Version](https://camo.githubusercontent.com/d136b20fb96eff65cd6e0d149d4593ffccb6dcd448563004ca0eac7da3cd3e03/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f4b6175616e43616c686569726f2f66616c6c6261636b2d6365702d617069)](https://github.com/KauanCalheiro/fallback-cep-api/releases)[![PHP Version](https://camo.githubusercontent.com/962aced9b09d89716dbebf186ff899754a096ff1068b6b7988675c2d9fab9331/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e322d626c75652e737667)](https://php.net/)[![Laravel](https://camo.githubusercontent.com/8736f326bbac4cde7bb2d12b2adf72e461e383e707b38c62b009c9aaf364a6dd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d25354531322e32302d7265642e737667)](https://laravel.com/)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)[![Downloads](https://camo.githubusercontent.com/3e4933faffe5b64649433a9e40d03c1cee49b083d8cdfdb32d3679c4131d585f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b616d6f63612f66616c6c6261636b2d6365702d617069)](https://packagist.org/packages/kamoca/fallback-cep-api)

Um pacote Laravel robusto e confiável para consulta de CEP com **fallback automático** entre múltiplos provedores de API. Nunca mais perca uma consulta por falha de API! 🚀

📖 **[Documentação Completa](#)** | 🚀 **[Guia de Instalação](#-instala%C3%A7%C3%A3o)** | 📋 **[Changelog](CHANGELOG.md)**

✨ Características
-----------------

[](#-características)

- 🔄 **Fallback automático** entre provedores
- ⚡ **Configuração de prioridades** para otimizar performance
- 🌐 **Múltiplos provedores** suportados (ViaCEP, BrasilAPI)
- 🛠️ **Fácil configuração** via arquivo de config
- 🌍 **Suporte a internacionalização** (PT-BR e EN)
- 📦 **Auto-discovery** do Laravel
- 🧪 **Padronização** de resposta entre provedores

📋 Requisitos
------------

[](#-requisitos)

[![PHP Version](https://camo.githubusercontent.com/962aced9b09d89716dbebf186ff899754a096ff1068b6b7988675c2d9fab9331/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e322d626c75652e737667)](https://php.net/)[![Laravel](https://camo.githubusercontent.com/8736f326bbac4cde7bb2d12b2adf72e461e383e707b38c62b009c9aaf364a6dd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d25354531322e32302d7265642e737667)](https://laravel.com/)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)

### Requisitos Mínimos

[](#requisitos-mínimos)

- **PHP**: 8.2 ou superior
- **Laravel**: 12.20 ou superior
- **Extensões PHP**:
    - `curl` (para requisições HTTP)
    - `json` (para processamento JSON)
    - `mbstring` (para manipulação de strings)

### Dependências do Composer

[](#dependências-do-composer)

- `illuminate/support`: ^12.20
- `illuminate/http`: Incluído no Laravel

### Compatibilidade

[](#compatibilidade)

LaravelPHPStatus12.x8.2+✅ Suportado11.x8.1+⚠️ Não testado10.x8.0+❌ Não suportado🚀 Instalação
------------

[](#-instalação)

Instale o pacote via Composer:

```
composer require kamoca/fallback-cep-api
```

### Publicar Configuração

[](#publicar-configuração)

Publique o arquivo de configuração para personalizar o comportamento:

```
php artisan vendor:publish --tag=cep-config
```

Isso criará o arquivo `config/cep.php` em seu projeto.

### Publicar Traduções (Opcional)

[](#publicar-traduções-opcional)

Para personalizar as mensagens de erro:

```
php artisan vendor:publish --tag=fallback-cep-translations
```

⚙️ Configuração
---------------

[](#️-configuração)

O arquivo `config/cep.php` permite configurar todos os aspectos do pacote:

### Variáveis de Ambiente

[](#variáveis-de-ambiente)

Adicione essas variáveis ao seu `.env` para configurar facilmente:

```
# Configurações do ViaCEP
FALLBACK_CEP_API_VIA_CEP_ENABLED=true
FALLBACK_CEP_API_VIA_CEP_PRIORITY=1

# Configurações do BrasilAPI
FALLBACK_CEP_API_BRASIL_API_ENABLED=true
FALLBACK_CEP_API_BRASIL_API_PRIORITY=2
```

🔧 Como Usar
-----------

[](#-como-usar)

### Usando o Helper do Container

[](#usando-o-helper-do-container)

```