APIs & KI - FastAPI

FastAPI - APIs mit Biss.

Schlanke, typisierte APIs für Integrationen und KI-Orchestrierung. OpenAPI inklusive - ohne Framework-Kathedrale.

OpenAPI Orchestrierung RAG Webhooks

Für wen FastAPI sitzt

Wenn Sie eine klare HTTP-Kante brauchen - vor Modellen, Jobs oder mehreren Clients.

KI ohne Tür

Ein Modell im Notebook, keine Auth, keine Limits. FastAPI wird die Tür.

Viele Clients

Shop, CRM, internes Tool. Ein Vertrag, Versionierung, Fehlercodes.

Webhooks & Events

Eingehende Events säubern, signieren, weiterreichen.

PHP bleibt Kern

Sie wollen nicht umziehen - nur eine schnelle Kante davor oder daneben.

Was wir in FastAPI liefern

Vertrag, Sicherheit, Betrieb.

APIs

Pydantic-Modelle, OpenAPI, Auth (Token/OIDC), Validation.

KI-Orchestrierung

RAG-Pipelines, Prompt-Routing, Fallbacks. Siehe KI-Einführung.

Jobs hinter der API

Lange Arbeit in Queues, Status-Endpoints, Webhooks zurück.

Anbindung

Bitrix24, Shopware, Symfony/Laravel - als Clients, nicht als Copy.

Ansatz: Vertrag zuerst

Bevor wir Modelle verdrahten, steht der API-Vertrag. Clients sollen gegen ein Schema bauen, nicht gegen unsere Laune.

  • Ressourcen und Auth festlegen
  • OpenAPI als Quelle, nicht als Nachtrag
  • Pilot mit Limits, Logs, Kostenkappe
  • Übergabe: Spec, Runbook, Staging

Typisches Umfeld

FastAPI, Python 3, Uvicorn/Gunicorn, oft Redis/Queue. Modelle per API. PHP-Systeme bleiben System of Record.

So entsteht eine FastAPI-Kante

Spec, Slice, Härten.

1

Vertrag

Endpoints, Fehler, Auth. Schriftlich.

2

Slice

Ein Flow in Staging gegen echte Daten.

3

Härten

Rate-Limits, Timeouts, Observability, PII.

4

Betreiben

Deploy, Metrics, optionale Wartung.

Worauf Integrationen bauen

APIs, die man zitieren kann.

OpenAPI ernst

Die Spec lügt nicht. Breaking Changes sind Arbeit, kein „Mittwoch“.

KI mit Bremse

Kosten, Timeouts, Human-in-the-loop - Teil des Designs.

Keine Schattenplattform

FastAPI orchestriert, es ersetzt nicht Ihr CRM.

Beispiel-Setup (Platzhalter)

Interner Assistent: FastAPI orchestriert RAG über Handbuch + Ticket-Historie, schreibt Entwürfe nach Bitrix24, eskaliert bei niedriger Sicherheit. Zielmetriken: Erstantwort, Quellen, Kosten pro Anfrage.

Häufige Fragen

API-Fragen, kurz.

FastAPI oder Node.js?

Python/KI-Nähe: FastAPI. JS-Team und BFF vor SPA: oft Node.js. Manchmal beides, klar getrennt.

Django / Flask?

Django wenn Admin/CMS in Python. Flask kennen wir. Für APIs+KI ist FastAPI meist der kürzere Weg.

Self-hosted LLM?

Wenn Datenschutz oder Kosten es verlangen. Sonst API-Modelle plus RAG.

Wie versionieren Sie?

URL oder Header, deprecation sichtbar. Clients bekommen Vorlauf.

Auth?

Token, OIDC oder m2m - je nach Client. Keine offenen Endpoints „weil intern“.

Einstieg?

Ein Vertrag + ein Flow. Fester Rahmen nach Kickoff.

Weitere Stacks

Verwandte Technologien, die wir oft daneben einsetzen.

Eine API mit Vertrag?

Sagen Sie uns Clients und den ersten Flow - wir skizzieren Spec und Pilot.