Zum Inhalt springen
use-cases / api-endpoints-on-demand / hero
EXEC · KI-NATIVE HTTP

API-Endpoints, die on-demand entstehen

Rufe eine URL auf, die nicht existiert. Ein Wildcard-Exec-Script fängt den Aufruf ab, fragt eine KI, den Handler zu schreiben, führt ihn in einer V8-Sandbox aus und antwortet. Der nächste Aufruf ist nativ — die Route existiert jetzt.

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

Wie eine URL zu einem Endpoint wird

Hoody Exec lässt eine einzelne TypeScript-Datei jeden HTTP-Route servieren, inklusive Catch-all. Mit ai true hat das Script auch ein Modell Handle injiziert. Kombiniere diese beiden und die Anfrage selbst wird der Trigger, um den Handler zu schreiben.

Wildcard Catch-all5 SCHRITTE · EINE EXEC DATEI
01

Anfrage kommt an

GET /api/...

Jeder Pfad unter dem Catch-all trifft ein Script.

02

Catch-all wacht auf

[...slug].ts

metadata.parameters.slug trägt die Pfad-Segmente.

03

KI schreibt einen Handler

generateText([ model ])

ai true injiziert das Modell. Standard ist gemini-2.5-flash-lite.

04

Laufe in einer V8 Sandbox

isolate.eval

Jedes Script läuft in seiner eigenen V8 Isolate, entworfen für vertrauenswürdigen Code.

05

Speichere die Route

fs.write to scripts/N

Nächster Aufruf trifft die gespeicherte Datei direkt. Keine KI, native Geschwindigkeit.

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 ?? []'';

// Schon gespeichert? Übergib an die gecachte Route.
const saved = await fs.exists('scripts/1/api' + path + '.ts');
if (saved) return fetch(path, [ method: metadata.method, body ]);

// Sonst: Frage nach einem Handler, Sandbox, speichere ihn.
const [ text: handler ] = await generateText([
  model,
  system: 'Gib ein JS Handler Body zurück. Keine Imports. Gib JSON zurück.',
  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;

Zwei Zauber-Kommentare und ein Fetch zurück in die Route. Der Wildcard sitzt bei scripts/1/api/[...slug].ts. Die gespeicherte Datei landet ein Verzeichnis höher. Beide sprechen HTTP, also kann das Script während der Generierung mit seinen eigenen Nachbarn sprechen.

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

Drei Leser, ein Muster

Der Mechanismus wird je nach Person anders gelesen. Sie verflechten sich zum selben Argument.

FÜR DEN FAULEN SENIOR ENGINEER

Stopp mit dem Schreiben von Endpoints, die du zweimal pro Jahr brauchst

Das Admin-Tool, das Integration-Script, den Report, den du schon lange anbinden wolltest. Rufe die URL auf, wenn du sie brauchst. Der Handler erscheint. Gespeichert, wenn du Reload drückst.

FÜR DEN KI-COLLABORATOR

Die KI programmiert den API nicht, sie ruft ihn auf

Deine KI braucht eine Route, die nicht existiert. Anderswo würde sie Code schreiben, deployen, warten, dann aufrufen. Hier ruft sie auf. Der API erscheint, bevor die Response kommt.

FÜR DIE RADIKALE ZUKUNFT

APIs werden nicht mehr entworfen, sie werden entdeckt

Was wäre, wenn jeder Endpoint, den du je deployed hast, nur die Spur der URLs ist, die du wirklich aufgerufen hast? Dokumentation schrumpft zum Access Log. Specs schrumpfen zu Traffic.

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

Dokumentation wird zum Access Log.

Montag aufgerufenDienstag dokumentiert
access.logjetzt ein 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

Was das ersetzt

Die Muster, die Entwickler greifen, wenn sie schnell einen Endpoint hinzufügen müssen. Jedes kostet Scaffold-Overhead pro Route. Der Wildcard zahlt es einmal.

  • AWS Lambda + API GatewayScaffold pro Endpoint, Cold Starts
  • Hasura / PostgREST AutogenSchema-first, gibt Daten zurück, nicht Verhalten
  • Vercel / Cloudflare FunctionsEinmalig Endpoint, ganzer Deploy-Cycle
  • Express / Fastify ScaffoldsBoilerplate pro Route, Runtime zum Betreuen
  • Kong / Tyk PluginsHeavy Gateway für eine Custom-Regel
  • BFF MicroservicesService zum Betreuen für jeden UI Quirk
use-cases / api-endpoints-on-demand / cta

Dokumentation ist kein Plan mehr. Es ist die Spur der URLs, die du aufgerufen hast.

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

Lies die anderen