A API do Devin permite que você integre o Devin às suas aplicações, automatize fluxos de trabalho e crie ferramentas poderosas. Fornecemos três versões de API, cada uma projetada para diferentes casos de uso e modelos de autenticação.
Devin oferece três versões de API, com diferentes funcionalidades e requisitos de autenticação:
A API v1 fornece funcionalidades principais de gerenciamento de sessões com acesso com escopo de organização.
Base URL: https://api.devin.ai/v1/*
Autenticação: Chaves de API pessoais ou de serviço
Principais recursos:
- Criar e gerenciar sessões do Devin
- Enviar mensagens para sessões ativas
- Gerenciar segredos, Knowledge e playbooks
- Carregar e baixar anexos
- Atualizar tags de sessão
Ideal para:
- Automação geral de sessões
- Integrações voltadas ao usuário
- Pipelines de CI/CD
- Desenvolvimento e testes
Ver documentação da API v1 →
Enterprise API v2 (apenas administradores Enterprise)
https://api.devin.ai/v2/enterprise/*
Autenticação: Apenas chaves de API pessoais de administradores Enterprise
Principais recursos:
- Análises e insights de sessões em toda a Enterprise
- Gerenciamento de organizações e membros
- Controle de consumo e dados de cobrança
- Logs de auditoria e relatórios de conformidade
- Gerenciamento de permissões Git
- Indexação de repositórios
Ideal para:
- Administradores Enterprise
- Análises e geração de relatórios
- Conformidade e auditoria
- Gerenciamento de organizações
Ver documentação da API v2 →
API de usuário de serviço v3 (RBAC)
https://api.devin.ai/v3beta1/enterprise/*https://api.devin.ai/v3beta1/organizations/*
Autenticação: Credenciais de usuário de serviço (nível Enterprise ou organizacional)
Principais funcionalidades:
- Controle de acesso baseado em função (RBAC) completo
- Usuários de serviço com funções dedicadas
- Permissões granulares
- Fluxos de trabalho multi-organização
- Separação clara entre contas humanas e de serviço
Ideal para:
- Automação em produção com permissões específicas
- Integrações multi-organização
- Fluxos de trabalho sensíveis a requisitos de conformidade
- Integrações de serviço de longa duração
Ver documentação da API v3 →
- Para a API v1: Gere uma chave de API em Settings > API Keys em qualquer sub-organização
- Para a API v2: Gere uma chave de API pessoal em Settings > API Keys em qualquer sub-organização
- Para a API v3: Crie um usuário de serviço em Enterprise Settings > Service Users
Mantenha suas chaves de API seguras e nunca as compartilhe em áreas acessíveis publicamente, como repositórios no GitHub ou código no lado do cliente.
Faça sua primeira requisição
Authorization:
Authorization: Bearer your_api_key_here
curl -X POST "https://api.devin.ai/v1/sessions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Crie um script Python simples que exiba Hello World"
}'
Todas as APIs usam códigos de status HTTP padrão:
200 OK: Solicitação bem-sucedida201 Created: Recurso criado com sucesso400 Bad Request: Parâmetros inválidos na solicitação401 Unauthorized: Chave de API ausente ou inválida403 Forbidden: Permissões insuficientes404 Not Found: Recurso não encontrado429 Too Many Requests: Limite de requisições excedido500 Internal Server Error: Erro no servidor
Em caso de dúvidas sobre a API ou para relatar problemas, envie um e-mail para [email protected].
