Cronograma de controle de versão

Saiba mais sobre o nosso esquema de evolução e a nossa estratégia de controle de versão para a API de informações sobre reservas.

Esquema de evolução

No mundo acelerado da tecnologia, permanecer à frente é crucial. É por isso que nossa API de análise foi projetada para acompanhar as suas necessidades. Com o nosso esquema de evolução, você recebe novos recursos no momento em que são desenvolvidos. Diga adeus às longas esperas por novos lançamentos e aos processos de atualização complicados.

Os nossos recursos mais recentes foram projetados para serem integrados de maneira otimizada, garantindo o uso contínuo da versão atual sem interrupções. Essa abordagem economiza tempo e dinheiro. Vamos manter você a par dos próximos recursos para que consiga se planejar muito bem.

Estratégia de controle de versão

Para atualizações ou alterações significativas que possam afetar as integrações existentes, apresentamos novas versões, como a API de análise v2.

A nossa equipe de API gerencia uma versão ativa enquanto desenvolve a próxima. Quando uma nova versão é lançada, passa a ser a ativa, enquanto a versão anterior entra em fase de descontinuação. As versões obsoletas permanecem disponíveis por um ano, proporcionando tempo suficiente para a transição. Durante esse período, apenas atualizações críticas de segurança são feitas na versão obsoleta.

Terminologia

Compreender o nosso cronograma de controle de versão é mais fácil com estas definições:

Ativa: a versão atual da API de análise, em que recursos e alterações são adicionadas sem interrupções. Você tem a flexibilidade de integrar esses recursos conforme desejar.

Desenvolvimento: a próxima versão da API em desenvolvimento.

Obsoleta: uma versão marcada como obsoleta indica que será descontinuada após um ano. Esse período é ideal para atualizar para a versão ativa mais recente.

Desativada: uma versão desativada não pode mais ser acessada por meio da API.

Alterações sem interrupção: são atualizações que podem ser integradas sem afetar a configuração existente. Incluem adições como novos pontos de extremidade, parâmetros de consulta opcionais e campos de resposta, entre outros.

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: atualizações significativas que podem exigir alterações na sua integração. Incluem a remoção de pontos de extremidade, a introdução de novos parâmetros necessários e alterações nas configurações de autenticação, entre outros. As alterações com interrupção são introduzidas apenas em novas versões ativas da API.

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.