Cronograma de controle de versão

Saiba mais sobre a nossa estratégia de controle de versão e esquema de evolução

Esquema de evolução

Inovação consiste em permanecer na vanguarda. Por isso projetamos a Rapid 3, para que você fique sempre à frente.

Com a Rapid 3 e o nosso esquema de evolução, você vai ter acesso aos recursos assim que estiverem disponíveis, sem ter que esperar 6 meses por novos lançamentos nem passar horas para atualizar cada nova versão.

Os lançamentos dos nossos recursos mais recentes não vão interromper a sua integração. Assim, você poderá usar a Rapid 3 por mais tempo, economizando tempo e dinheiro. Também vamos avisar quando esses recursos serão lançados, para que você possa se programar com antecedência.

Estratégia de controle de versão

Recursos maiores ou alterações importantes serão lançados em novas versões, como Rapid 4.

As nossas equipes de tecnologia da Rapid API mantêm uma versão ativa da API e outra em desenvolvimento. Quando lançarmos uma versão mais recente, essa versão vai ficar ativa e a anterior será marcada como obsoleta. A versão obsoleta ficará disponível por um ano antes de ser desativada, para que você tenha tempo suficiente para migrar para a versão mais recente lançada. Durante esse período, apenas as principais correções de segurança serão implementadas na versão obsoleta.

Terminologia

Confira algumas definições para você conhecer o nosso cronograma de controle de versão:

Ativa: a versão atual e ativa da Rapid API. Os recursos de alteração sem interrupção podem ser adicionados a uma versão ativa a qualquer momento, e você decide se deseja integrar esses recursos ou não.

Desenvolvimento: a próxima versão do Rapid em que estamos trabalhando.

Obsoleta: quando uma versão é marcada como obsoleta, essa é a indicação de que a versão não estará mais disponível após um ano. Esse é um bom momento para atualizar para a versão ativa mais recente.

Desativada: quando uma versão for desativada, essa versão não vai poder mais ser acessada por meio da API.

Alterações sem interrupção: essas alterações são recursos que podem ser adicionados a uma versão ativa a qualquer momento sem interromper a sua integração.

As alterações sem interrupção incluem:

• A adição de novos pontos de extremidade.
• A adição de novos parâmetros de consulta opcionais.
• A adição de novos campos de solicitação opcionais aos corpos da solicitação.
• A adição de novos cabeçalhos opcionais à solicitação.
• A alteração de parâmetros de solicitação obrigatórios para opcionais.
• A adição de novos campos a uma resposta.
• A adição de novos cabeçalhos à resposta.
• A adição de novos valores a uma enumeração de solicitação.
• A adição de novos valores a uma enumeração de resposta com um padrão.

Alterações com interrupção: as alterações com interrupção são atualizações de recursos maiores que podem interromper a sua integração existente. Só vamos lançar alterações importantes nas novas versões ativas da Rapid, para que você não precise se preocupar com a integração existente.

As alterações com interrupção incluem:

• A remoção de pontos de extremidade existentes.
• A adição de novos parâmetros de consulta obrigatórios.
• A adição de novos campos de solicitação obrigatórios aos corpos da solicitação.
• A adição de novos cabeçalhos obrigatórios à solicitação.
• A alteração de parâmetros de solicitação de opcionais para obrigatórios.
• A remoção ou renomeação de parâmetros de consulta.
• A remoção ou renomeação de campos de resposta.
• A alteração do tipo de parâmetros de consulta.
• A alteração do tipo de campos de solicitação no corpo da solicitação.
• A adição de novos requisitos de validação a parâmetros existentes.
• A remoção ou eliminação das configurações de autenticação ou autorização.
• A remoção ou renomeação de valores de enumeração.
• A adição de novos valores a uma enumeração de resposta sem um padrão.