Skip to content

API_TEST_GUIDE.md

Latest commit

 

History

History
88 lines (62 loc) · 2.04 KB

API_TEST_GUIDE.md

File metadata and controls

88 lines (62 loc) · 2.04 KB
Raw

🔧 Test-Anleitung: Richtiges API-Endpoint testen

Das Problem

curl http://localhost:8005/api/
# 404 Not Found HTML

Das ist eigentlich OK - /api/ ist nur ein Prefix, kein echtes Endpoint!

Die Lösung

Testen Sie mit einem echten API-Endpoint:

# ✅ RICHTIG - Login Endpoint
curl -X POST http://localhost:8005/api/login \
  -H "Content-Type: application/json" \
  -d '{"username":"test","password":"test"}'

# ✅ RICHTIG - User Data Endpoint  
curl http://localhost:8005/api/me

# ✅ RICHTIG - Projects Endpoint
curl http://localhost:8005/api/projects

# ✅ RICHTIG - Health Check
curl http://localhost:8005/check_health

Warum /api/ allein 404 gibt

In den URLs ist /api/ nur ein Prefix:

path(webserver_path, include("webserver.urls"))
# webserver_path = "api/"
# → /api/ ist nur ein PREFIX!

# Echte Endpoints sind:
# /api/login        ← include("webserver.urls") → path("login")
# /api/me           ← include("webserver.urls") → path("me")
# /api/projects     ← include("webserver.urls") → path("projects")

Richtige Test-Kommandos

# Test 1: Login (POST)
curl -X POST http://localhost:8005/api/login \
  -H "Content-Type: application/json" \
  -d '{"username":"secure-user@acme.de","password":"secure"}'

# Test 2: Authentifizierte Anfrage (braucht Cookie/Token)
curl -i http://localhost:8005/api/me

# Test 3: Health Check (kein Auth nötig)
curl http://localhost:8005/check_health

# Test 4: Projects (mit Auth)
curl http://localhost:8005/api/projects

Success Criteria

✅ Endpoints geben JSON zurück (nicht HTML!) ✅ 404 für /api/ allein ist OK (es ist nur Prefix) ✅ 401 bei Auth-Endpoints ohne Auth ist OK ✅ 200 mit JSON für echte Requests

Überprüfung: Backend serviert KEINE HTML mehr

# ❌ SCHLECHT: HTML Response
<html>
<head><title>Not Found</title></head>
...

# ✅ GUT: JSON Response
{"detail":"Authentication credentials were not provided."}

# ✅ GUT: JSON Response  
{"username":"...","email":"..."}

Testen Sie jetzt mit echten Endpoints!