Ir al contenido
use-cases / api-endpoints-on-demand / hero
EXEC · HTTP NATIVO DE IA

Endpoints de API que se materializan bajo demanda

Golpea una URL que no existe. Un script exec con comodín captura la llamada, le pide a un LLM que escriba el manejador, lo ejecuta en un sandbox V8 y responde. La siguiente llamada es nativa — la ruta ahora existe.

use-cases / api-endpoints-on-demand / mechanism

Cómo una URL se convierte en un endpoint

Hoody Exec permite que un solo archivo TypeScript sirva cualquier ruta HTTP, incluyendo un comodín. Con ai true, el script también tiene un modelo inyectado. Compón esos dos y la solicitud misma se convierte en el disparador para escribir el manejador.

Captura de comodín5 PASOS · UN ARCHIVO EXEC
01

Llega la solicitud

GET /api/...

Cualquier ruta bajo el comodín toca un solo script.

02

Se despierta el comodín

[...slug].ts

metadata.parameters.slug lleva los segmentos de la ruta.

03

El LLM escribe un manejador

generateText([ model ])

ai true inyecta el modelo. El predeterminado es gemini-2.5-flash-lite.

04

Ejecuta en un sandbox V8

isolate.eval

Cada script se ejecuta en su propio aislamiento V8, diseñado para código de confianza.

05

Guarda la ruta

fs.write to scripts/N

La siguiente llamada toca el archivo guardado directamente. Sin LLM, velocidad nativa.

scripts/1/api/[...slug].ts
// @mode serverless
// @ai true
// @ai-model anthropic/claude-sonnet-4.5

const path = '/' + (metadata.parameters.slug ?? []).join('/');
const body = req.body ?? []'';

// ¿Ya guardado? Pasa a la ruta cacheada.
const saved = await fs.exists('scripts/1/api' + path + '.ts');
if (saved) return fetch(path, [ method: metadata.method, body ]);

// En caso contrario: pide un manejador, lo coloca en sandbox, guárdalo.
const [ text: handler ] = await generateText([
  model,
  system: 'Retorna un cuerpo del manejador JS. Sin imports. Retorna JSON.',
  prompt: `URL $[metadata.method] $[path]\nQuery $[JSON.stringify(metadata.query)]\nBody $[JSON.stringify(body)]`,
]);

const result = await isolate.eval(handler, [ req, res, fetch ]);
await fs.write('scripts/1/api' + path + '.ts', '// @mode serverless\n' + handler);
return result;

Dos comentarios mágicos y una llamada fetch de vuelta en la ruta. El comodín se sienta en scripts/1/api/[...slug].ts. El archivo guardado desciende un directorio. Ambos hablan HTTP, así que el script puede llamar a sus propios vecinos durante la generación.

use-cases / api-endpoints-on-demand / angles

Tres lectores, un patrón

El mecanismo se lee de tres formas diferentes dependiendo de quién eres. Se trenzan en el mismo argumento.

PARA EL INGENIERO SENIOR PEREZOSO

Deja de escribir el endpoint que usas una vez al año

La herramienta de admin, el script de integración, el reporte que siempre quisiste conectar. Golpea la URL cuando la necesites. El manejador aparece. Guardado para cuando recargues.

PARA EL COLABORADOR DE AGENTES

El agente no programa la API, la llama

Tu agente necesita una ruta que no existe. En cualquier otro lugar, escribiría código, desplegaría, esperaría, luego llamaría. Aquí, simplemente llama. La API llega en el momento en que lo hace la respuesta.

PARA EL FUTURO RADICAL

Las APIs ya no se diseñan, se descubren

¿Qué pasa si cada endpoint que alguna vez enviaste es solo el rastro de URLs que realmente llamaste? La documentación colapsa en el registro de acceso. Las especificaciones colapsan en el tráfico.

use-cases / api-endpoints-on-demand / punchline

La documentación se convierte en el registro de acceso.

llamado lunesdocumentado martes
access.logahora un endpoint
  • 09:14GET/api/analytics/dashboardlive
  • 11:02POST/api/exports/users.csvlive
  • 13:48GET/api/admin/seats/auditlive
  • 16:22POST/api/agent/tools/refundlive
use-cases / api-endpoints-on-demand / replaces

Lo que esto reemplaza

Los patrones a los que los desarrolladores recurren cuando necesitan añadir un endpoint rápidamente. Cada uno carga sobrecarga de andamiaje por ruta. El comodín lo paga una sola vez.

  • AWS Lambda + API GatewayAndamiaje por endpoint, arranques en frío
  • Hasura / autogeneración PostgRESTPrimero el esquema, devuelve datos no comportamiento
  • Funciones Vercel / CloudflareEndpoint único, ciclo completo de despliegue
  • Andamiajes Express / FastifyAndamiaje por ruta, tiempo de ejecución para cuidar
  • Plugins Kong / TykGateway pesado para una regla personalizada
  • Microservicios BFFServicio que mantener para cada peculiaridad de UI
use-cases / api-endpoints-on-demand / cta

La documentación deja de ser un plan. Es el rastro de URLs que has llamado.

use-cases / api-endpoints-on-demand / related

Lee los otros