AuthAPI

Description

L’API d’authentification du projet. 2 profils d’utilisateurs sont à votre disposition : coach et guest.

• coach (mot de passe : admin) : Vous donne accès à tout type de requête pour l’API de gestion.
• guest (mot de passe : invite) : Vous donne seulement accès aux requêtes GET.

URL de base

L’URL de base pour toutes les requêtes de cette API est :

https://volleycoachpro.alwaysdata.net/authapi/

Types de requêtes

POST

Renvoie un jeton JWT permettant de s’authentifier sur le site et d’effectuer des requêtes sur les API de gestion. Il sera valable 1h.

Corps de la requête

• login : Le nom d’utilisateur
• password : Le mot de passe

Réponse

Retourne un objet JSON avec les propriétés suivantes :

• token : Le jeton JWT à inclure dans toutes les prochaines requêtes dans l’en-tête de la requête à coté d’Authorization Bearer.
• user : Le nom de l’utilisateur authentifié

Exemple

Corps de la requête:

{
"login": "coach",
"password": "admin"
}

Réponse :

{
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsb2dpbiI6ImNvYWNoIiwiZXhwIjoxNzQzODYwODE2fQ.lQT_bVCxGh443ekyJ0CDPXZ6orCoa5bns_u_nx-WKO0",
    "user": "Coach"
}

GET

Vérifie la validité d’un jeton JWT existant pour autoriser les requêtes vers les API de gestion.

En-tête de la requête

Authorization Bearer <votreToken>

Réponse

Retourne un objet JSON avec les propriétés suivantes :

• message : Un message explicite indiquant que l’accès a été authorisé**.**
• login : Le nom de l’utilisateur authentifié.
• status : Le status de la réponse (ici : success).

Exemple

Réponse :

{
    "message": "Accès autorisé",
    "login": "coach",
    "status": "success"
}

Erreurs

L’API peut renvoyer les erreurs suivantes :

• POST :
  • 400 Bad Request : "Données manquantes"
  • 401 Unauthorized: "Identifiants invalides"
• GET :
  • 403 Forbidden : "Accès refusé"
• Autres :
  • 405 Method not allowed : "Méthode non autorisée"

Pour les API qui vont suivre, il faudra mettre votre jeton JWT dans l'en-tête de vos requêtes

VolleyAPI : Statistiques

Description

L'API permettant d’afficher les statistiques relatives aux joueurs et aux rencontres.

URL de base