Jetbrains

Suspendendo a API REST Legada: Ação Necessária

Este post é um lembrete sobre alterações importantes nos aspectos técnicos da criação de integrações externas com o YouTrack, bem como as ações que os administradores do YouTrack e os encarregados por definir as integrações externas para suas equipes devem realizar até o final de junho de 2021.

O que está mudando?

Há dois anos, anunciamos que tínhamos começado gradualmente a publicar novos recursos e métodos da API REST. Fizemos nosso melhor para tornar a nova API segura e flexível o suficiente para permitir que nossos usuários criassem integrações personalizadas de forma eficiente, ao mesmo tempo em que abordamos os pontos problemáticos na API legada.

A nova API REST agora é um recurso totalmente suportado e com qualidade para lançamento, e é hora de suspender os métodos legados, pois gostaríamos de concentrar nossos esforços na manutenção e no aprimoramento dessa nova API.

Estamos planejando iniciar a transição em julho de 2021 e pretendemos concluí-la até o final do ano. Obviamente, vamos garantir que todas as nossas bibliotecas, plug-ins e widgets oficiais sejam migrados para a nova API antes de desativar a API legada.

Quais são os métodos da API REST legados?

Os métodos da API REST do YouTrack são usados principalmente para desenvolver integrações personalizadas entre o YouTrack e ferramentas de terceiros, estendendo a funcionalidade nativa do YouTrack. Por exemplo, uma integração poderia buscar issues do YouTrack e, em seguida, desenvolver um gráfico personalizado com base nos dados. Se a sua equipe criou alguma integração personalizada, reserve um momento para analisá-la. Os métodos legados são aqueles que usam o prefixo de URL /rest, enquanto os novos métodos são aqueles que usam /api.

Ação necessária para nossos usuários

Assim que a transição for concluída, será impossível usar a API REST legada nas versões do YouTrack lançadas em julho de 2021 ou posteriores. Todas as integrações personalizadas que dependerem dos métodos da API REST legados também deixarão de funcionar. Certifique-se de migrar todo o seu código personalizado para a nova API REST antes de julho de 2021 para evitar interrupções no seu trabalho diário. Depois de 1º de julho de 2021, não poderemos mais garantir que os métodos da API REST legados funcionarão.

A documentação da nova API REST fornece descrições detalhadas de novos endpoints, e nós também fornecemos um conjunto de exemplos que você pode usar para se familiarizar com a nova API.

E quanto às integrações do YouTrack com ferramentas externas?

Entendemos que há várias integrações do YouTrack amplamente utilizadas, mas que não podem ser modificadas por nossos usuários, por exemplo, integrações com sistemas de gerenciamento de teste. Estamos planejando entrar em contato com representantes dessas aplicações para comunicar as alterações futuras e fornecer toda a ajuda que pudermos para garantir que essas integrações sejam migradas para a nova API REST.

Se você tiver dúvidas ou precisar de ajuda com a migração das suas integrações para a nova API REST, entre em contato com a nossa equipe de suporte. Estamos sempre felizes em ajudar!

Equipe do YouTrack

Powered by WPeMatico