| Índice | ||||
|---|---|---|---|---|
|
Os padrões de Open Banking Finance podem não cobrir todas as possibilidades de objetos retornados ou APIs que os participantes desejam expor. Os participantes podem ter o desejo de realizar inovações sobre os padrões definidos oferecendo mais dados afim de atender demandas específicas de mercado. É nossa intenção que os padrões definidos não apenas permitam estas extensões como também sirvam como base para futuras alterações na própria definição dos padrões.
...
Participantes que desejam estender os padrões devem adicionar seu prefixo para identificar todas as extensões. Campos adicionais no retorno de endpoints existentes ou em novos endpoints devem usar o prefixo do participante. O prefixo deve ser criado no formato exposto ao lado (4 letras) e não devem haver seguinte formato: “EXT-”, seguidos por 4 letras, não devendo existir prefixos duplicados entre os participantes. Veja o exemplo Abaixo:
Exemplo de instituição fictícia: “EXT-FICT”
Nesta documentação, quando tivermos que nos referir ao prefixo do participante, o termo <PID> será utilizado.
Exemplos de Código
Cada participantes terá um ID que representa a sua instituição. Os participantes da na atual versão estão listados deverão atualizar seus PIDs para contemplar o novo formato de PID conforme exemplo apresentado abaixo:
EXT-BBAS - Banco do Brasil
EXT-BBCD - Bradesco
EXT-BTGP - BTG Pactual
EXT-CAIX - Caixa Econônica Federal
EXT-ITAU - Itau
EXT-STDR - Santander
EXT-BRGS - Banrisul
EXT-BNBR - Banco do Nordeste do Brasil
EXT-BNDS - BNDES
EXT-CITI - Citibank
EXT-SAFR - Safra
EXT-BABV - Votorantim
Novas APIs
...
Extensão do versionamento
Como descrito na seção versionamento, o versionamento existe apenas no nível das APIs e não no nível dos endpoints, no entanto caso seja necessário realizar versionamento de um endpoint customizado, o participante poderá utilizar o header x-<PID>-v para que o consumidor possa especificar qual versão do endpoint está requisitando.