Gestion Des Utilisateurs

Authentification

L'authentification est le processus permettant de vérifier l'identité d'un utilisateur avant de lui donner accès aux ressources de l'application ou aux API. Dans le cadre de notre API HOGI-SMS, l'authentification garantit que seuls les utilisateurs autorisés peuvent générer un token et accéder aux endpoints sécurisés.

Endpoint: POST /api/users/generate-token/

Authentification: Non-requise

Paramètres (Query):

Nom	Type	Obligatoire	Description
username	string	Oui	Nom d'utilisateur utilisé pour se connecter.
password	string	Oui	Mot de passe associé au compte utilisateur.
days	integer	Non	Durée (en jours) de validité du token généré.

Exemple de requête:


{
  "username": "gadiel",
  "password": "motdepasse123",
  "days": 7
}

Exemple de Réponse:


{
  "access": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in_days": 7
}

Changement de Mot de Passe

Le changement de mot de passe permet à un utilisateur de mettre à jour ses identifiants de connexion afin de renforcer la sécurité de son compte. Cette opération est essentielle pour protéger l'accès aux ressources de l'API HOGI-SMS et garantir que seules les personnes autorisées peuvent utiliser un compte.

Endpoint: POST /api/users/changepassword/

Authentification:

Requise - Un jeton Bearer doit être envoyé dans l'en-tête :

Authorization: Bearer < votre-jeton >

Paramètres (Query):

Nom	Type	Obligatoire	Description
old_password	string	Oui	Ancien mot de passe de l'utilisateur
new_password	string	Oui	Nouveau mot de passe à appliquer

Exemple de requête:


{
  "old_password": "motdepasse123",
  "new_password": "motdepasse456"
}

Exemple de Réponse:


{
  "message": "Le mot de passe a été modifié avec succès."
}

Révocation De Token

La révocation de token (ou blacklist) permet d'invalider un token de rafraîchissement (refresh token) afin qu'il ne puisse plus être utilisé pour obtenir de nouveaux jetons d'accès. Cette fonctionnalité est essentielle pour déconnecter un utilisateur en toute sécurité, par exemple lorsqu'il se déconnecte ou qu'un risque de compromission est détecté.

Endpoint: POST /api/users/blacklist_token/

Authentification:

Requise - Un jeton Bearer doit être envoyé dans l'en-tête :

Authorization: Bearer < votre-jeton >

Paramètres (Query):

Nom	Type	Obligatoire	Description
refresh	string	Oui	Le refresh token à blacklister (révoquer)

Exemple de requête:


{
  "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Exemple de Réponse:


{
  "message": "Le token a été révoqué avec succès."
}