Voltar para a home
Documentação técnica

Guia de Documentação

Arquitetura, módulos e referência completa da API REST da Codigocode.

Visão geral

A Codigocode entrega análise, modernização e implantação segura de sistemas legados. A API REST permite integrar o processo com pipelines CI/CD, ferramentas internas e scripts.

Todos os endpoints são versionados, retornam JSON e são organizados por recursos de análise, migração, infraestrutura, qualidade, segurança e modelagem de dados.

Este guia é destinado a clientes e parceiros da Codigocode em avaliação técnica. Se ainda não tem acesso, fale conosco primeiro.

Primeiros passos

Cada solicitação à API usa um bearer token obtido ao trocar as credenciais da sua conta por um JWT de curta duração.

curl -X POST https://api.codigocode.io/auth/login \ -H "Content-Type: application/json" \ -d '{"username": "your-user", "password": "your-password"}'

A resposta contém um access_token. Envie-o como bearer token em cada solicitação posterior.

curl https://api.codigocode.io/api/explorer-plus/projects \ -H "Authorization: Bearer <access_token>"

Os tokens têm validade limitada e incluem sua função e cota. Não existe uma API key separada.

Módulos

Cada módulo oferece uma capacidade independente. A maioria das equipes começa com o Explorer para análises somente de leitura.

Explorer
Mapeamento automatizado do codebase, diagramas de arquitetura, grafos de dependências e critérios de aceitação com acesso somente de leitura.
Revitalize
Motor de migração multiagente com pontos de revisão humana para modernizar codebases legados de forma incremental.
Code Guardian
Controle de qualidade e segurança integrado ao Git que combina análise estática e revisão com IA em cada pull request.
Cloud Infrastructure
Descoberta multi-cloud em AWS, Azure e GCP com segurança, custos, drift e geração de IaC.
Schema Forge
Geração de modelos SQL normalizados e scripts de migração a partir de planilhas com análise de lacunas.
Code Forge
Geração contextual de funcionalidades, código, testes e documentação a partir de uma única especificação.
Code Graph
Visualização interativa do grafo de dependências do projeto: nós, relações e subgrafos navegáveis para entender o impacto de uma mudança antes de fazê-la.
Code Editor
Editor de código integrado à plataforma para inspecionar e editar arquivos do projeto sem sair do navegador, conectado aos demais módulos de análise.
Test Generator
Geração automática de testes unitários e de integração a partir do código existente, com cobertura sugerida por arquivo.
Feature Builder
Empacota o contexto de uma funcionalidade -- código, tickets do Jira, resumo do projeto -- em um único pacote pronto para gerar a implementação.
Smart Chat
Assistente conversacional com contexto híbrido (AST + busca semântica) para perguntar sobre qualquer projeto conectado.
Agent Cells
Células de agentes autônomos: equipes completas de IA (Product Owner, desenvolvedores, QA, DevOps, segurança) que você ativa e desativa como unidade para executar um desenvolvimento de ponta a ponta.

Referência de API

Acesso de parceiro

A Codigocode oferece uma API REST completa para autenticação, projetos e todos os recursos acima. A documentação endpoint por endpoint é compartilhada com clientes e parceiros em avaliação técnica.

Grupos da API

GrupoRota baseInclui
Authentication/authLogin, renovação de sessão e usuário atual
Explorer/api/explorer-plusAnálise de codebase, arquitetura e critérios de aceitação
Revitalize/api/migrationPlanejamento, execução e revisões de migração
Cloud Infrastructure/api/cloud-infraDescoberta, segurança, custos e geração de IaC
Code Guardian/code-guardianControle de qualidade e segurança, webhooks de PR
Schema Forge/api/db-modelsModelos de banco de dados a partir de planilhas
Code Forge/feature-forgeSessões do FeatureForge, integração com Jira, geração de requisitos/design/tarefas
Code Graph/api/projectsGrafo de dependências do projeto, subgrafos e estatísticas
Feature Builder/api/feature-builderImportação do Jira, pacotes de contexto de funcionalidade
Test Generator/api/test-generatorGeração de testes e status de execução
Smart Chat/smart-chatConsultas conversacionais com contexto do projeto
Agent Cells/api/agent-cellsCélulas de agentes, agentes por função e tarefas
GET/api/explorer-plus/projects/{id}/analysis
{ "project_id": "8f21...", "status": "completed", "acceptance_criteria_sets": [ ... ], "architecture": { "diagram": "graph TD ..." } }
POST/api/cloud-infra/snapshots/{id}/analyze
A referência completa é para parceiros e clientes
Insira as credenciais compartilhadas com você para consultar todos os endpoints, parâmetros, esquemas, erros e exemplos.
Não tem credenciais? Solicitar acesso de parceiro.

Segurança e conformidade

A Codigocode foi criada para empresas com requisitos rigorosos de dados. Pode operar on-premise, em nuvem privada ou sem conexão, e o código-fonte nunca sai do seu ambiente.

ISO 27001
Gestão de segurança da informação alinhada aos controles ISO 27001.
SOC Type II
Controles auditados de forma independente para segurança, disponibilidade e confidencialidade.
Preparado para air gap
Implantação offline completa para ambientes regulados e classificados.