Référence API

L'API WXRK est une API REST construite sur Django REST Framework. La documentation interactive est disponible à :

• Swagger UI — /api/docs/swagger/
• ReDoc — /api/docs/redoc/
• Schéma OpenAPI — /api/schema/

Authentification

L'API utilise des tokens JWT Bearer.

Obtenir un token

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

{
  "username": "votre@email.com",
  "password": "votre-mot-de-passe"
}

Réponse :

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

Rafraîchir le token

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

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

Utiliser le token

Incluez le token d'accès dans toutes les requêtes authentifiées :

Authorization: Bearer <jwt-access-token>

Gestion du profil

Obtenir le profil

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

Mettre à jour le profil

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

{
  "full_name": "Jean Dupont",
  "location": "Paris, FR",
  "linkedin_url": "https://linkedin.com/in/jeandupont"
}

Revue Technique

Lister les expériences

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

Créer une expérience

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

{
  "company_name": "Acme Corp",
  "job_title": "Ingénieur Backend Senior",
  "start_date": "2022-01",
  "end_date": "2024-06"
}

Candidatures

Lister les candidatures

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

Paramètres de requête :

• status — Filtrer par statut (draft, generated, submitted, interview, offer, rejected)
• ordering — Trier par champ (-created_at, company_name)

Créer une candidature

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

{
  "job_description": "Nous recherchons un ingénieur backend...",
  "job_url": "https://entreprise.com/emplois/123"
}

Génération IA

Générer un CV

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

Réponse :

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

Interroger le statut de la tâche

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

Valeurs de statut : PENDING → STARTED → SUCCESS | FAILURE

Tableau de bord

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

Retourne les statistiques récapitulatives et le fil d'activité récente.