Cronograma de versionamento da API de hospedagem

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 o Rapid API para que você nunca precise interromper seu ritmo.

Com nosso esquema em constante evolução, você recebe os recursos assim que eles estiverem prontos. sem ter que esperar 6 meses por novos lançamentos nem passar horas para atualizar cada nova versão.

Nossos lançamentos de recursos mais recentes não interromperão sua integração, para que você possa continuar usando o Rapid 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

Quando lançarmos funcionalidades maiores ou alterações que quebrem a compatibilidade, iremos implementá-las em uma nova versão.

Nossas equipes de tecnologia mantêm uma versão ativa da API, com 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:

Ativo: A versão atual do Rapid API. Os recursos de alteração ininterrupta 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.

Obsolecência: Quando uma versão é marcada como obsoleta, isso indica 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:

Novos pontos de extremidade
Novos parâmetros de consulta opcionais
Novos campos de solicitação opcionais nos corpos da solicitação
Novos cabeçalhos opcionais na solicitação
Parâmetros de solicitação obrigatórios que passam a ser opcionais
Novos campos em uma resposta
Novos cabeçalhos nas respostas
Novos valores para uma enumeração de solicitação
Novos valores para 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:

Remover pontos de extremidade existentes
Adicionar novos parâmetros de consulta obrigatórios
Adicionar novos campos de solicitação obrigatórios nos corpos da solicitação
Adicionar novos cabeçalhos obrigatórios na solicitação
Alterar parâmetros de solicitação de opcionais para obrigatórios
Remover ou renomear parâmetros de consulta
Remover ou renomear campos de resposta
Alterar o tipo de parâmetros de consulta
Alterar o tipo de campo de solicitação no corpo da solicitação
Adicionar novos requisitos de validação em parâmetros existentes
Remover ou eliminar as configurações de autenticação ou autorização
Remover ou renomear valores de enumeração
Adicionar novos valores para uma enumeração de resposta sem um padrão