feat: campo logo_url no /banks/v1 (issue #834) by lucianopf · Pull Request #886 · BrasilAPI/BrasilAPI · GitHub
Skip to content

feat: campo logo_url no /banks/v1 (issue #834) - #886

Merged
lucianopf merged 3 commits into
mainfrom
feat/banks-logo-url
Aug 10, 2026
Merged

lucianopf merged 3 commits into
mainfrom
feat/banks-logo-url

Conversation

@lucianopf

Copy link
Copy Markdown
Member

Feature #834: logo_url nos bancos

Adiciona o campo opcional logo_url na resposta de GET /api/banks/v1 (lista e /{code}).

Design

  • CDN pública (jsDelivr) do projeto logos-bancos-br (do autor da issue) — zero infra, zero chave, URL versionada não envelhece
  • Snapshot local services/banco-central/logo-urls.json (476 ISPB→URL, do pacote npm 0.6.2) — sem chamada externa por request
  • enrichBanksWithLogoUrl aplicado no retorno único do service → cobre CSV do BCB, snapshot em disco e fallback banksList
  • Compatível retroativo: campo novo opcional; null para bancos sem logo (315/469 hoje, 33% de cobertura)

Exemplo

{
  "ispb": "00000000",
  "name": "BCO DO BRASIL S.A.",
  "code": 1,
  "fullName": "Banco do Brasil S.A.",
  "logo_url": "https://cdn.jsdelivr.net/npm/logos-bancos-br@0/logos/svg/00000000.svg"
}

Verificação

  • 3 testes novos: logo presente (BB), null para sem-logo, campos existentes intactos
  • Lint limpo · doc atualizada (schema Bank)

lucianopf and others added 3 commits August 10, 2026 16:45
…rvices

- CI: step de ESLint no workflow E2E (lint nunca rodava — 43 erros passaram despercebidos)
- lint: mapUfToUfCode (42x prettier), weather.js, cpf (console.log redundante), cep-error-handler (disable scoped)
- teste NCM: expect.assertions + comportamento real (200 [] pós-984c956) — antes passava sem validar nada
- move pages/api/indices/codes.js → services/indices/codes.js (módulo de constantes virava rota 500 em produção)

Co-authored-by: Hermes Agent <noreply@nousresearch.com>
Auditoria achou 26 rotas sem doc + ~10 params divergentes (doc PT-BR vs
código EN, dos rebases #861-#876). Correções:
- params renomeados: fipe (tipoVeiculo→vehicleType...), ibge (siglaUF→uf...),
  cptec (icaoCode→airport), ibpt (siglaUF→uf), solar (path→query)
- paths novos: /ibge/uf/v1/regiao, /fipe/marcas/v1, /feriados/v1, /oms/cid10/v1,
  /status/v1 (cid10.json + status.json novos)
- eleicoes.json: prefixo /api removido dos paths
- holydays/statewide: path fantasma {ano}/{uf} removido (UF é query)
- ibpt: ?ex=01 removido do path key (query param)
- teste novo: docs-parity.test.js (paridade rotas reais ↔ doc)

Co-authored-by: Hermes Agent <noreply@nousresearch.com>
Adiciona logo_url (CDN jsDelivr do projeto logos-bancos-br, do autor da
issue) para bancos com logo mapeado por ISPB; null nos demais (154/469
hoje, 33%).

- snapshot services/banco-central/logo-urls.json (476 ISPB→URL, gerado
  do pacote npm logos-bancos-br@0.6.2)
- enrich em getBanksData cobre todos os caminhos (CSV/snapshot/fallback)
- doc: schema Bank com logo_url opcional (string|null)
- testes: logo presente, null para sem-logo, compatibilidade retroativa

Co-authored-by: Hermes Agent <noreply@nousresearch.com>
@vercel

vercel Bot commented Aug 10, 2026

Copy link
Copy Markdown

@sonarqubecloud

Copy link
Copy Markdown

@lucianopf
lucianopf merged commit 9b04461 into main Aug 10, 2026
4 checks passed
@lucianopf
lucianopf deleted the feat/banks-logo-url branch August 10, 2026 20:43

This branch was successfully deployed

1 active deployment
Preview — ec55567f Deployed Aug 10, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant