Esta seção explica as etapas para cadastrar os endpoints de recursos de uma API.
Cadastramento de Recursos - Fase 1
Para cada uma das famílias de APIs devem ser adicionadas todos os endpoints disponíveis. Supondo que a instituição tenha disponibilizado dados em todos os endpoints da fase 1, a publicação deveria ser:
Cadastramento de Recursos - Fase 2
Na Fase 2 o padrão de cadastramento continua como na Fase 1, segue alguns pontos de atenção:
Para a API de consentimento é necessário apenas o cadastramento de uma entrada para o GET e o DELETE;
A API de customers foi dividida em duas famílias para facilitar o consumo pelos receptores. Customers-business onde é cadastrado os Endpoints PJ e customers-personal onde será cadastrado os endpoints PF. Cabendo aqui o cadastramento conforme a disponibilização do produto pela instituição;
O cadastramento de recursos deve respeitar a tabela de etapas da implementação assistida, conforme IN BCB n° 136 de 29/7/2021;
Para as APIs v2 da Fase 2 será necessário adicionar novos Family tipes informando a versão 2 e sua certificação.
Cadastramento de Recursos - Fase 3
Na Fase 3 o padrão de segue alguns pontos de atenção:
A API de payments foi dividida para facilitar o consumo pelos iniciadores.
Na família de payments-consents devem ser declarados os endpoints de consentimento.
Na família de payments-pix devem ser declarado sos endpoints da forma de pagamento PIX.
Demais formas de pagamentos devem ser cadastradas conforme as especificações avancem.
Tabela Exemplo de Recursos - Fase 1
Tabela Exemplo de Recursos - Fase 2
Tabela Exemplo de Recursos - Fase 2 v2
Tabela Exemplo de Recursos - Fase 3
API | Diretório (Family Type) | Recursos (resources) |
|
| payments-consents https://api.banco.com.br/open-banking/payments/v1/consents https://api.banco.com.br/open-banking/payments/v1/consents/{consentId} payments-pix https://api.banco.com.br/open-banking/payments/v1/pix/payments https://api.banco.com.br/open-banking/payments/v1/pix/payments/{paymentId} |
| Âncora | ||||
|---|---|---|---|---|
|
Requisitos
1. No Diretório, localize e selecione a sua organização.
2. Selecione o menu Authorisation Serverse clique no link do servidor de autorização na qual se deseja cadastrar os recursos.
3. No canto superior esquerdo da página clique em API Resources.
4. Na página que será carregada clique no botão New API Resources para abrir a janela New API Resource.
5. Na janela New API Resource, clique na caixa de seleção API Family Type e selecione uma das opções disponíveis.
6. No campo ao lado, em Version especifique o valor apropriado utilizando versionamento semântico (major.minor.patch, exemplo 1.0.7)
7. No campo Certification URL é necessário informar a URL onde se encontra a localização do certificado publicado no GitHub. Esse preenchimento é obrigatório para famílias de API’s a partir da Fase 2 e clique no botão Save.
| Informações |
|---|
NOTA 1: A URL a ser informada deve ser a presente no GitHub no caminho: Exemplo: https://openbanking-brasil.github.io/conformance/submissions/functional/<family-type>/<version>/<file-name>.zip NOTA 2: No ambiente de Sandbox do Diretório, caso não exista uma certificação, é possível incluir um endereço para testes: https://openbanking-brasil.github.io/teste.zip |
8. De volta a tela API Resources, informe URL principal no campo API Discovery Endpoints, e em seguida pressione a tecla Enter.
9. Para cada uma das famílias de APIs repita os passos 4 a 7.
| Informações |
|---|
NOTA: Todos os endpoints deverão ser preenchidos, incluindo os respectivos recursos. Para obter mais detalhes sobre o padrão do endpoints e versão consulte o Portal do Desenvolvedor do Open Finance. |
| Âncora | ||||
|---|---|---|---|---|
|
Na Fase 4A o padrão de cadastro segue alguns pontos de atenção:
O cadastro das APIs deve ser realizado individualmente, para cada um dos recursos/endpoints existirá um tipo de família (Family Type)
Diferente das outras famílias, ao requisitar o cadastro dessas APIs, será executado um teste de conformidade funcional que verificará a conformidade da API com a especificação do Swagger
O diretório só permitirá o cadastro da API caso o teste de conformidade seja bem sucedido
Semelhante a Fase 1, a publicação do recurso é condiciona a IF possuir tal produto, logo, não necessariamente todos os recursos precisam ser publicados
Cadastramento de Recursos - Fase 4A (1/2)
API | Diretório (Family Type) | Recursos (resources) |
|
|
https://api.banco.com.br/open-banking/opendata-investments/v1/funds
https://api.banco.com.br/open-banking/opendata-investments/v1/bank-fixed-incomes
https://api.banco.com.br/open-banking/opendata-investments/v1/credit-fixed-incomes
https://api.banco.com.br/open-banking/opendata-investments/v1/variable-incomes
https://api.banco.com.br/open-banking/opendata-investments/v1/treasure-titles |
|
|
https://api.banco.com.br/open-banking/opendata-capitalization/v1/bonds |
|
|
https://api.banco.com.br/open-banking/opendata-exchange/v1/online-rates
https://api.banco.com.br/open-banking/opendata-exchange/v1/vet-values |
Cadastramento de Recursos - Fase 4A (2/2)
API | Diretório (Family Type) | Recursos (resources) |
|
|
https://api.banco.com.br/open-banking/opendata-acquiring-services/v1/personals
https://api.banco.com.br/open-banking/opendata-acquiring-services/v1/businesses |
|
|
https://api.banco.com.br/open-banking/opendata-pension/v1/risk-coverages
https://api.banco.com.br/open-banking/opendata-pension/v1/survival-coverages |
|
|
https://api.banco.com.br/open-banking/opendata-insurance/v1/automotives
https://api.banco.com.br/open-banking/opendata-insurance/v1/homes
https://api.banco.com.br/open-banking/opendata-insurance/v1/personals |
| Âncora | ||||
|---|---|---|---|---|
|
Requisitos
1. No Diretório, localize e selecione a sua organização.
2. Selecione o menu Authorisation Serverse clique no link do servidor de autorização na qual se deseja cadastrar os recursos.
3. No lado esquerdo da tela clique em API Resources
4. Clique no botão New API Resources para abrir a janela New API Resource
5. Na janela New API Resource, clique na caixa de seleção API Family Type e selecione uma das opções disponíveis que possuem certificação automática
6. No campo ao lado, em Versionespecifique o valor da versão da API conforme especificação
7. No campo THE URL FOR THE APIé necessário informar a URL referente ao recurso da API a ser registrado
8. A URL da API deve seguir o formato especificado no portal do desenvolvedor, caso contrário o diretório irá retornar um erro, não permitindo a continuidade do cadastro
9. Ao selecionar Saveuma janela irá aparecer informando que ao pressionar OK um teste de conformidade será executado contra o recurso preenchido acima
| Informações |
|---|
NOTA 1: O valor informado no campo NOTA 2: Caso o teste de conformidade não seja bem sucedido é possível consultar os logs de execução do teste que impediu a publicação da API. Para isso basta copiar a URL apresentada na mensagem de erro e colar na barra do navegador. |
10. Caso a execução seja mal sucedida, é possível consultar os detalhes que geraram a falha em View Logs.
11. Caso o teste seja bem sucedido, a nova API será adicionada automaticamente a tabela de recursos do Authorisation Server
12. A coluna referente a API CERTIFICATION URLtambém será preenchida automaticamente e apresentada na tabela.
13. Caso seja necessário atualizar a URL do recurso adicionado basta clicar no botão editar ou em apagar.
| Âncora | ||||
|---|---|---|---|---|
|
Requisitos
1. No Diretório, localize e selecione a sua organização.
2. Selecione o menu Servidores de Autorização. Na tela ao lado, selecione o servidor de autorização no qual o recurso será removido.
3. De volta ao menu, selecione a opção Recursos do API, e na tela ao lado, localize o Tipo da Família da API (API Family Type) que será removido.
4. Clique no ícone Excluir para remover a família de recursos e suas APIs.
| Informações |
|---|
NOTA: Para remover pontualmente um recurso dentro de um |