API-Referenz

Die WXRK-API ist eine REST-API, die auf Django REST Framework basiert. Interaktive Dokumentation ist verfügbar unter:

• Swagger UI — /api/docs/swagger/
• ReDoc — /api/docs/redoc/
• OpenAPI-Schema — /api/schema/

Authentifizierung

Die API verwendet JWT Bearer-Tokens.

Token erhalten

POST /api/token/
Content-Type: application/json

{
  "username": "ihre@email.de",
  "password": "ihr-passwort"
}

Antwort:

{
  "access": "<jwt-access-token>",
  "refresh": "<jwt-refresh-token>"
}

Token aktualisieren

POST /api/token/refresh/
Content-Type: application/json

{
  "refresh": "<jwt-refresh-token>"
}

Token verwenden

Fügen Sie das Zugriffstoken in alle authentifizierten Anfragen ein:

Authorization: Bearer <jwt-access-token>

Profilverwaltung

Profil abrufen

GET /api/profile/
Authorization: Bearer <token>

Profil aktualisieren

PATCH /api/profile/
Authorization: Bearer <token>
Content-Type: application/json

{
  "full_name": "Max Mustermann",
  "location": "Berlin, DE",
  "linkedin_url": "https://linkedin.com/in/maxmustermann"
}

Technische Überprüfung

Erfahrungen auflisten

GET /api/technical-review/experiences/
Authorization: Bearer <token>

Erfahrung erstellen

POST /api/technical-review/experiences/
Authorization: Bearer <token>
Content-Type: application/json

{
  "company_name": "Acme GmbH",
  "job_title": "Senior Backend-Ingenieur",
  "start_date": "2022-01",
  "end_date": "2024-06"
}

Bewerbungen

Bewerbungen auflisten

GET /api/applications/
Authorization: Bearer <token>

Abfrageparameter:

• status — Nach Status filtern (draft, generated, submitted, interview, offer, rejected)
• ordering — Nach Feld sortieren (-created_at, company_name)

Bewerbung erstellen

POST /api/applications/
Authorization: Bearer <token>
Content-Type: application/json

{
  "job_description": "Wir suchen einen Backend-Ingenieur...",
  "job_url": "https://unternehmen.de/stellen/123"
}

KI-Generierung

Lebenslauf generieren

POST /api/applications/{id}/generate-cv/
Authorization: Bearer <token>

Antwort:

{
  "task_id": "abc-123",
  "status": "PENDING"
}

Aufgabenstatus abfragen

GET /api/tasks/{task_id}/
Authorization: Bearer <token>

Statuswerte: PENDING → STARTED → SUCCESS | FAILURE

Dashboard

GET /api/dashboard/
Authorization: Bearer <token>

Gibt Zusammenfassungsstatistiken und den Aktivitäts-Feed zurück.