Consulta de Bancos com PHP integrando a BrasilAPI

📖 Sobre o projeto

O Consulta de Bancos com PHP integrando a BrasilAPI é uma aplicação web desenvolvida em PHP 8+ para consultar instituições financeiras brasileiras por meio da API pública da BrasilAPI.

O projeto demonstra o consumo de uma API REST com cURL, o tratamento de respostas JSON e a separação de responsabilidades entre entrada da aplicação, integração HTTP e apresentação dos dados.

As consultas podem ser realizadas por uma interface web simples ou consumidas diretamente em formato JSON. Como os dados são obtidos de um serviço externo, a aplicação depende da disponibilidade da BrasilAPI.

Organização da aplicação

Requisição do usuário
        ↓
index.php
        ↓
BankService.php
        ↓
BrasilAPI via cURL
        ↓
Tratamento dos dados JSON
        ↓
Resposta HTML ou JSON

O arquivo index.php recebe os parâmetros e define o tipo de resposta. A classe BankService.php concentra a comunicação HTTP e as regras de consulta, enquanto View.php auxilia no escape e na normalização dos textos exibidos.

✨ Funcionalidades

• Listagem completa das instituições financeiras disponíveis;
• busca por nome da instituição;
• busca por código COMPE;
• busca por código ISPB;
• página de detalhes de um banco específico;
• resposta em JSON para a listagem;
• resposta em JSON para os detalhes;
• interface web para consulta e visualização dos dados;
• normalização e escape dos textos apresentados.

Parâmetros de consulta

Parâmetro	Finalidade
q	Pesquisa bancos por nome, código ou ISPB
code	Exibe os detalhes do banco correspondente
format=json	Altera a resposta da aplicação para JSON

🖼️ Screenshots

A imagem abaixo apresenta a interface principal da aplicação:

🚀 Tecnologias

• PHP 8+: processamento das requisições e organização da aplicação;
• cURL: comunicação HTTP com a BrasilAPI;
• BrasilAPI: fonte dos dados das instituições financeiras;
• JSON: formato recebido da API e disponibilizado pelos endpoints;
• HTML5: estrutura da interface;
• CSS3: apresentação visual da aplicação.

⚙️ Como executar

Pré-requisitos

• PHP 8.0 ou superior;
• extensão cURL habilitada;
• acesso à internet para consultar a BrasilAPI;
• navegador ou cliente HTTP.

Iniciar o servidor

Abra um terminal na pasta do projeto e execute:

php -S 127.0.0.1:8000 -t .

Exemplos de acesso

Listagem:

http://127.0.0.1:8000/index.php

Busca:

http://127.0.0.1:8000/index.php?q=itau

Detalhe:

http://127.0.0.1:8000/index.php?code=1

JSON da listagem:

http://127.0.0.1:8000/index.php?format=json

JSON do detalhe:

http://127.0.0.1:8000/index.php?code=1&format=json

📂 Estrutura do projeto

A estrutura separa a entrada da aplicação, o serviço de integração, os recursos de apresentação e os estilos:

.
├── index.php
├── src/
│   ├── BankService.php
│   └── View.php
├── assets/
│   └── styles.css
├── Amostradoprojeto.PNG
└── README.md

• index.php: entrada da aplicação, roteamento e geração da resposta;
• src/BankService.php: requisições HTTP e regras de busca e detalhamento;
• src/View.php: funções de escape e normalização de texto;
• assets/styles.css: estilos da interface;
• Amostradoprojeto.PNG: screenshot do projeto;
• README.md: documentação técnica.

🌐 Deploy

O projeto é uma aplicação PHP tradicional e pode ser hospedado em qualquer servidor web compatível com PHP 8+ e com a extensão cURL habilitada.

Para execução local, podem ser utilizados XAMPP, Laragon, WAMP ou o servidor embutido do PHP. Em uma hospedagem remota, os arquivos devem ser publicados preservando a estrutura dos diretórios.

A aplicação necessita de acesso externo e depende da disponibilidade da BrasilAPI para realizar as consultas. Indisponibilidades ou alterações no serviço podem afetar os resultados.

👤 Autor

Natan Da Luz

• LinkedIn: linkedin.com/in/natandaluz
• Portfólio: portfolionatan.vercel.app
• E-mail: natandaluz01@gmail.com

📄 Licença

Este projeto está sem uma licença definida no momento.