REST (Representational State Transfer)

Einfach erklärt

REST (Representational State Transfer) ist das Architekturmuster, das das Web antreibt. Es definiert, wie Client und Server über HTTP kommunizieren – mit klaren Konventionen für URLs (Ressourcen), HTTP-Methoden (GET lesen, POST erstellen, PUT aktualisieren, DELETE löschen) und Statuscodes. Für KI-Systeme ist REST der Standard, um Modelle als API bereitzustellen: Ein POST-Request mit dem Input, ein JSON-Response mit der Vorhersage. Alle großen KI-APIs – OpenAI, Anthropic, Google – folgen REST-Konventionen.

REST (Representational State Transfer) ist das dominante Architekturmuster für Web-APIs. Es definiert, wie Client und Server über HTTP kommunizieren – mit klaren Konventionen für URLs, HTTP-Methoden (GET, POST, PUT, DELETE) und Statuscodes. Für KI-Systeme ist REST der Standard, um Modelle als API bereitzustellen: Ein POST-Request mit dem Input, ein JSON-Response mit der Vorhersage.

REST ist ein Architekturstil, der definiert, wie Web-APIs aufgebaut sein sollten. Fast alle KI-APIs (OpenAI, Anthropic, Google) nutzen REST.

Beispiel – OpenAI Chat API:

POST https://api.openai.com/v1/chat/completions
Headers: Authorization: Bearer sk-...
Body: {"model": "gpt-5", "messages": [{"role": "user", "content": "Hallo!"}]}

Response: {"choices": [{"message": {"content": "Hallo! Wie kann ich helfen?"}}]}

REST-Prinzipien:

Prinzip	Beschreibung
Zustandslos	Jede Anfrage ist unabhängig, kein Session-State auf dem Server
Ressourcen-basiert	Alles ist eine Ressource mit eigener URL
Einheitliche Schnittstelle	Standardisierte HTTP-Methoden und Statuscodes
Client-Server	Klare Trennung zwischen Frontend und Backend

Technischer Deep Dive

HTTP-Statuscodes

• 200 OK: Erfolgreiche Anfrage
• 201 Created: Ressource erfolgreich erstellt
• 400 Bad Request: Fehlerhafte Anfrage
• 401 Unauthorized: Nicht authentifiziert
• 404 Not Found: Ressource nicht gefunden
• 429 Too Many Requests: Rate Limit erreicht
• 500 Internal Server Error: Serverfehler

REST API Design

GET    /api/v1/models          → Liste aller Modelle
GET    /api/v1/models/gpt-5    → Details eines Modells
POST   /api/v1/chat/completions → Chat-Anfrage senden
DELETE /api/v1/files/file-123   → Datei löschen

Pagination, Filtering, Sorting

• Pagination: ?page=2&limit=20 oder Cursor-basiert
• Filtering: ?status=active&category=llm
• Sorting: ?sort=created_at&order=desc