Volver a la home
Documentación técnica

Guía de Documentación

Arquitectura, módulos y referencia completa de la API REST de Codigocode.

Resumen

Codigocode entrega análisis, modernización y despliegue seguro de sistemas legacy. La API REST permite integrar el proceso con pipelines CI/CD, herramientas internas y scripts.

Todos los endpoints están versionados, devuelven JSON y se organizan por capacidades de análisis, migración, infraestructura, calidad, seguridad y modelado de datos.

Esta guía está dirigida a clientes y socios de Codigocode en evaluación técnica. Si todavía no tienes acceso, contáctanos primero.

Primeros pasos

Cada solicitud a la API se autentica con un bearer token obtenido al intercambiar las credenciales de tu cuenta por un JWT de corta duración.

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

La respuesta incluye un access_token. Envíalo como bearer token en cada solicitud posterior.

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

Los tokens tienen vigencia limitada e incluyen tu rol y cuota. No existe una API key separada.

Módulos

Cada módulo ofrece una capacidad independiente. La mayoría de los equipos comienza con Explorer para realizar análisis de solo lectura.

Explorer
Mapeo automatizado del codebase, diagramas de arquitectura, grafos de dependencias y criterios de aceptación con acceso de solo lectura.
Revitalize
Motor de migración multiagente con puntos de revisión humana para modernizar codebases legacy de forma incremental.
Code Guardian
Control de calidad y seguridad integrado con Git que combina análisis estático y revisión con IA en cada pull request.
Cloud Infrastructure
Descubrimiento multi-cloud en AWS, Azure y GCP con seguridad, costos, drift y generación de IaC.
Schema Forge
Generación de modelos SQL normalizados y scripts de migración desde hojas de cálculo con análisis de brechas.
Code Forge
Generación contextual de funcionalidades, código, pruebas y documentación desde una sola especificación.
Code Graph
Visualización interactiva del grafo de dependencias del proyecto: nodos, relaciones y subgrafos navegables para entender el impacto de un cambio antes de tocarlo.
Code Editor
Editor de código integrado en la plataforma para inspeccionar y editar archivos del proyecto sin salir del navegador, conectado al resto de los módulos de análisis.
Test Generator
Generación automática de pruebas unitarias y de integración a partir del código existente, con cobertura sugerida por archivo.
Feature Builder
Empaqueta el contexto de una funcionalidad -- código, tickets de Jira, resumen del proyecto -- en un solo paquete listo para generar la implementación.
Smart Chat
Asistente conversacional con contexto híbrido (AST + búsqueda semántica) para preguntar sobre cualquier proyecto conectado.
Agent Cells
Células de agentes autónomos: equipos completos de IA (Product Owner, developers, QA, DevOps, seguridad) que activás y desactivás como unidad para ejecutar un desarrollo de punta a punta.

Referencia de API

Acceso de socio

Codigocode ofrece una API REST completa para autenticación, proyectos y todas las capacidades anteriores. La documentación endpoint por endpoint se comparte con clientes y socios en evaluación técnica.

Grupos de API

GrupoRuta baseIncluye
Authentication/authInicio de sesión, renovación y usuario actual
Explorer/api/explorer-plusAnálisis de codebase, arquitectura y criterios de aceptación
Revitalize/api/migrationPlanificación, ejecución y revisiones de migración
Cloud Infrastructure/api/cloud-infraDescubrimiento, seguridad, costos y generación de IaC
Code Guardian/code-guardianControl de calidad y seguridad, webhooks de PR
Schema Forge/api/db-modelsModelos de base de datos desde hojas de cálculo
Code Forge/feature-forgeSesiones de FeatureForge, integración con Jira, generación de requerimientos/diseño/tareas
Code Graph/api/projectsGrafo de dependencias del proyecto, subgrafos y estadísticas
Feature Builder/api/feature-builderImportación de Jira, paquetes de contexto de funcionalidad
Test Generator/api/test-generatorGeneración de pruebas y estado de ejecución
Smart Chat/smart-chatConsultas conversacionales con contexto del proyecto
Agent Cells/api/agent-cellsCélulas de agentes, agentes por rol y tareas
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
La referencia completa es para socios y clientes
Ingresa las credenciales compartidas contigo para consultar todos los endpoints, parámetros, esquemas, errores y ejemplos.
¿No tienes credenciales? Solicitar acceso de socio.

Seguridad y cumplimiento

Codigocode está diseñado para empresas con requisitos estrictos de datos. Puede ejecutarse on-premise, en nube privada o sin conexión, y el código fuente nunca sale de tu entorno.

ISO 27001
Gestión de seguridad de la información alineada con los controles ISO 27001.
SOC Type II
Controles auditados de forma independiente para seguridad, disponibilidad y confidencialidad.
Preparado para air gap
Despliegue offline completo para entornos regulados y clasificados.