API
Endpoints
Liste complète des endpoints de l'API TrickSpin.
Endpoints
Authentification
| Méthode | Route | Description | Auth |
|---|---|---|---|
POST | /api/users/login | Connexion - émet les cookies JWT | Non |
POST | /api/users/logout | Déconnexion - supprime les cookies JWT | Oui |
POST | /api/users/signup | Inscription | Non |
POST | /api/users/forgot-password | Demande de réinitialisation de mot de passe | Non |
POST | /api/users/reset-password | Réinitialisation du mot de passe | Non |
Utilisateur
| Méthode | Route | Description | Auth |
|---|---|---|---|
GET | /api/users/profil | Récupérer le profil de l'utilisateur connecté | Oui |
PATCH | /api/users/update-pseudo | Modifier le pseudo | Oui |
PATCH | /api/users/update-password | Modifier le mot de passe | Oui |
PATCH | /api/users/update-email | Modifier l'email | Oui |
DELETE | /api/users | Supprimer le compte | Oui |
GET | /api/users/score | Récupérer le score King of Cable | Oui |
GET | /api/users/activity | Historique d'activité | Oui |
GET | /api/users/monthly-validated-combos | IDs des combos validés sur le défi mensuel (filtres optionnels) | Oui |
Tricks (Combos)
| Méthode | Route | Description | Auth |
|---|---|---|---|
GET | /api/combos/ | Liste de tous les tricks | Non |
GET | /api/combos/{slug} | Détail d'un trick | Non |
GET | /api/combos/figure-of-the-week | Trick de la semaine | Non |
GET | /api/users/random-trick | Suggestion intelligente pour la roue du hasard (combo ou grab) | Oui |
GET | /api/users/random-unvalidated-combo | Trick aléatoire non maîtrisé (sans moteur intelligent) | Oui |
POST | /api/users/combos | Enregistrer un trick comme maîtrisé | Oui |
DELETE | /api/users/combos | Retirer un trick du profil | Oui |
POST | /api/users/figure-of-the-week | Valider le trick de la semaine | Oui |
DELETE | /api/users/figure-of-the-week | Retirer la validation du trick de la semaine | Oui |
Grabs
| Méthode | Route | Description | Auth |
|---|---|---|---|
GET | /api/grabs/ | Liste des grabs | Non |
GET | /api/grabs/{slug} | Détail d'un grab | Non |
GET | /api/users/grabs | IDs des grabs maîtrisés par l'utilisateur | Oui |
POST | /api/users/grabs | Marquer un grab comme maîtrisé | Oui |
DELETE | /api/users/grabs | Retirer un grab du profil | Oui |
Voir Roue du hasard intelligente pour le détail du moteur de suggestion (WheelSuggestionEngine, delta, progression des familles).
Données de référence
Ces endpoints sont publics et retournent les données nécessaires à la construction des tricks.
| Méthode | Route | Description |
|---|---|---|
GET | /api/categories/ | Liste des catégories (avec points King of Cable) |
GET | /api/categories/{slug}/combos | Tricks mensuels de la catégorie (fallback legacy si mois non seedé) |
GET | /api/approaches/ | Liste des approches |
GET | /api/grabs/ | Liste des grabs |
GET | /api/sides/ | Liste des sides |
GET | /api/ways/ | Liste des ways |
GET | /api/jibin/ | Liste des jibin |
GET | /api/jibout/ | Liste des jibout |
GET | /api/tricks/ | Liste des rotations |