Sugestão: campo logo_url opcional no /banks/v1 · Issue #834 · BrasilAPI/BrasilAPI · GitHub
Skip to content

Sugestão: campo logo_url opcional no /banks/v1 #834

Closed

Description

@rzmt

Fala! Uso bastante o BrasilAPI e queria sugerir uma coisa no endpoint de bancos.

O /api/banks/v1 já devolve o ispb de cada banco, mas nenhuma imagem. Seria útil um logo_url opcional com o logo oficial da instituição. Como os logos são chaveados por ISPB, dá pra casar direto com o que a resposta já traz.

As imagens viriam de um projeto que eu mantenho, o logos-bancos-br (https://github.com/rzmt/logos-bancos-br). É tudo de fonte oficial (listas de participantes do STR e do Pix do BC, mais o diretório do Open Finance), cada logo com a origem registrada (URI, sha256 e data), licença MIT, e o repo se reconstrói e republica sozinho toda semana (npm + CDN), então a URL não envelhece.

Ficaria assim (só o logo_url é campo novo):

{
  "ispb": "60701190",
  "name": "ITAÚ UNIBANCO S.A.",
  "code": 341,
  "fullName": "ITAÚ UNIBANCO S.A.",
  "logo_url": "https://cdn.jsdelivr.net/npm/logos-bancos-br@0/logos/svg/60701190.svg"
}

A URL é do jsDelivr, então não tem imagem pra hospedar aí. O padrão é /logos/svg/{ISPB}.svg (tem png também).

Pra ser transparente na cobertura: hoje 475 das 1.112 instituições têm logo, e nas outras o campo viria null. Vi também que manter a lista de participantes em dia já dá trabalho manual por aqui (#779, #780); o pipeline do projeto lê os mesmos CSVs do BC toda semana, então daria pra usar pra isso também, mas a ideia aqui é só o logo_url mesmo.

Se fizer sentido eu mando o PR. Só me falem se preferem referenciar a URL do CDN ou copiar o mapa ISPB->logo pro repositório. Valeu!

Activity

  1. lucianopf commented on Aug 10, 2026

    @lucianopf
    Member

    Implementado! 🎉 PR #886 merged e no ar: o campo logo_url agora vem em GET /api/banks/v1 (lista e por código). Usa o CDN jsDelivr do seu projeto logos-bancos-br — 155/481 bancos cobertos hoje, null nos demais. Obrigado pela sugestão e pelo projeto! 🙏

  2. rzmt commented on Aug 10, 2026

    @rzmt
    Author

    Muito obrigado por implementar, @lucianopf! Ficou ótimo, valeu demais pela força!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions