Ciclo de Vida

Etapas do ciclo de vida da API

• Design: etapa em que um dos GTs de Especificações de Dados Abertos, Dados do Cliente e/ou Serviços estão construindo uma nova versão da API. Nesta etapa a parte das especificações já desenvolvidas e aprovadas pelo GT serão disponibilizadas no ambiente de Draft na Área do Desenvolvedor no Portal do Open Finance.

  • O início das discussões sobre a evolução da API pelos GTs de Especificações marca o início desta etapa.

• Implementing: etapa em que a nova versão da API (unstable) estará disponível para implementação.

  • O evento de publicação da nova versão da API na Área do Desenvolvedor marcará o início desta etapa;

  • Poderá ser usada para reportar possíveis bugs nas especificações;

  • As detentoras/transmissoras devem iniciar as implementações a partir da publicação da nova versão da API.

• Certifying: etapa em que a versão unstable da API estará disponível para implementação e certificação.

  • O evento de liberação do uso dos motores de certificação marcará o início desta etapa;

  • Poderá ser usada para reportar possíveis bugs nas especificações ou nos motores de teste.

• Current: etapa que indica a versão oficial da API que deve estar em produção. Quando uma nova versão da API (x+1) entrar em produção a versão antiga (versão x) sairá da etapa current para deprecated durante o período de convivência e a nova versão (versão x+1) sairá da etapa certifying para current.

  • O evento de entrada em produção marcará o início desta etapa.

• Deprecated: etapa em que a versão atual (versão x) da API está sendo substituída pela próxima versão (x+1) em ambiente produtivo pelos participantes dando início ao período de convivência destas versões.

  • O evento de entrada em produção da próxima versão da API marcará o início desta etapa.

• Retired: etapa em que a versão da API se torna indisponível em ambiente produtivo.

  • O evento de remoção desta versão da API do ambiente produtivo marcará o início desta etapa.

Período de convivência

• Quando temos a versão x em deprecated, significa que a versão x+1 está em current;

• Este período é utilizado para que tenhamos uma transição mais suave entre a versão que está sendo aposentada (retired) e a versão que está se tornando oficial (current);

• Neste período, teremos obrigatoriamente os participantes detentores de conta e transmissores de dados com as duas versões em produção, desde o primeiro dia do período de convivência, enquanto que os iniciadores de pagamento e os receptores de dados estarão lançando em produção suas implementações da versão x+1, sendo obrigatório o lançamento completo até o final do período de convivência;

• O período de convivência terá no máximo duas versões da mesma API convivendo.

Open