Pular para o conteúdo principal
Esta página registra as alterações específicas nas APIs do Devin (v1, v2 e v3). Para lançamentos de recursos do aplicativo, consulte as Notas de versão do aplicativo.
Atualizações da API v3
- Roteadores de Notes e Playbooks (1º de dezembro): foram adicionados endpoints de gerenciamento de Notes e Playbooks em nível de Enterprise e de organização à API v3. Os endpoints de Notes exigem a permissão
ManageAccountKnowledge, e os endpoints de Playbooks exigem a permissão ManageAccountPlaybooks.
Atualizações da API v2 Enterprise
- Atualização do limite de paginação (21 de nov.): limite máximo de paginação reduzido de 1000 para 200 itens por requisição, para melhorar o desempenho e a confiabilidade. O limite padrão continua 100. Esta mudança NÃO afeta a API Externa v1.
- Roteador de sessões (16 de nov.): adicionados endpoints abrangentes de gerenciamento de sessões à API v2 para administradores Enterprise.
- Endpoint da API de snapshots (3 de nov.): adicionado endpoint para recuperar detalhes de snapshots de forma programática.
Atualizações da API v1
- Endpoint para encerrar sessão (31 de out.): adicionado endpoint para encerrar sessões em execução de forma programática.
Lançamento da API v3 (Beta)
- Lançamento da API v3 (23 de out): Lançada a API v3 com suporte completo a RBAC, modelo de autenticação de usuário de serviço e registro de auditoria abrangente para ações de usuários de serviço.
Atualizações da API v2 Enterprise
- Endpoint de criação de snapshot (30 de out): Novo endpoint da API Enterprise Organizations v2 para administradores Enterprise clonarem repositórios programaticamente e criarem snapshots com etapas de configuração personalizadas e comandos de inicialização.
- Melhorias na API de Playbooks (14 de out): Nova API para publicar playbooks Enterprise com funcionalidade aprimorada para gerenciamento programático de playbooks.
Atualizações da API Enterprise v2
- Roteador de funções Enterprise (25 set): Adicionado roteador de funções Enterprise com cinco endpoints de API para gerenciar funções programaticamente.
Atualizações da API v1
- API de Playbooks (6 set): Adicionados endpoints completos da API de Playbooks na v1 para criar, atualizar, listar e excluir playbooks programaticamente.
- Endpoint de segredos (5 set): Adicionado novo endpoint
POST /v1/secrets para criar segredos via API.
Lançamento da Enterprise API v2
- Lançamento da Enterprise API v2 (23 de mar): Lançamento da Enterprise API v2 para administradores Enterprise, com recursos de gerenciamento de organizações, monitoramento de consumo e gerenciamento de membros.
Lançamento da API v1 (26 de outubro)
- API REST para criação e gerenciamento programático de sessões
- Endpoints de criação, monitoramento e gerenciamento de sessões
- Suporte para upload e download de arquivos anexos
- Autenticação básica com Chaves de API
- Suporte à criação idempotente de sessões
- Casos de uso: revisões automáticas de PRs, resolução de erros de lint, migrações
Política de Versionamento da API
- Anunciadas com pelo menos 7 dias de antecedência
- Documentadas nessas notas de versão
- Acompanhadas por guias de migração, quando aplicável
Processo de descontinuação
- Anúncio: Anunciaremos a descontinuação e o respectivo cronograma
- Período de descontinuação: O recurso permanece disponível, mas marcado como descontinuado
- Remoção: O recurso é removido após o período de descontinuação
- v1: Disponível para uso geral, com manutenção ativa
- v2: Disponível para uso geral, com manutenção ativa
- v3: Beta - sujeito a alterações, ainda não recomendado para uso em produção
Se você estiver criando novas integrações que exigem permissões granulares, considere usar o v3 em vez do v1:
Principais diferenças:
- Autenticação: o v3 requer tokens de usuário de serviço em vez de chaves de API pessoais/de serviço
- Autorização: o v3 fornece controle de acesso baseado em função (RBAC) completo, com permissões baseadas em funções
- Endpoints: o v3 usa padrões de URL diferentes (
/v3beta1/* em vez de /v1/*)
Etapas de migração:
- Crie um usuário de serviço em Enterprise Settings > Service Users
- Atribua funções apropriadas ao usuário de serviço
- Gere uma chave de API para o usuário de serviço
- Atualize sua integração para usar os endpoints do v3
- Teste minuciosamente em um ambiente de não produção
Ver documentação da API v3 →
A v3 oferece mais flexibilidade do que a v2 para automação em ambiente Enterprise:
Principais diferenças:
- Autenticação: a v3 usa usuários de serviço em vez de exigir chaves pessoais de Enterprise Admin
- Autorização: a v3 oferece suporte a RBAC granular em vez de acesso apenas para Enterprise Admins
- Escopo: a v3 pode ser limitada a organizações específicas, enquanto a v2 é sempre em nível Enterprise
Quando migrar:
- Você precisa de automação com permissões sem privilégios de administrador
- Você quer limitar o acesso à API a organizações específicas
- Você precisa de uma separação clara entre contas humanas e contas de serviço
- Você exige registros de auditoria detalhados para ações automatizadas
Em caso de dúvidas sobre alterações na API ou necessidade de assistência na migração:
