Authentication / API Auth
Verification de la validité du code
Une fois le code généré pour l'utilisateur il suffit de vérifier la validité en utilisant l'api suivante
#6acfe5> https://auth.axolotl-app.com/verify/?username={username}&code={code}
Code valide
Lorsque le code est valide l'api renvoie:
#adff8f>
#adff8f> {
#adff8f> "status": "success",
#adff8f> "data": "dioto"
#adff8f> }
#adff8f>
Code expiré
Lorsque le code est expiré aprèes 60 secondes l'api renvoie:
#ff6251>
#ff6251> {
#ff6251> "status": "error",
#ff6251> "data": "code expired"
#ff6251> }
#ff6251>
Code déja utilisé
Lorsque le code est déja utilisé l'api renvoie:
#ff6251>
#ff6251> {
#ff6251> "status": "error",
#ff6251> "data": "code used"
#ff6251> }
#ff6251>
Code correspondance
Lorsque le code ne correspond pas l'api renvoie:
#ff6251>
#ff6251> {
#ff6251> "status": "error",
#ff6251> "data": "code doesn't match"
#ff6251> }
#ff6251>
Exemple d'implémentation
Voici un exemple de code en javascript qui peut être implémenté a un site internet. Ce système est souvent utilisé pour une boutique ou il est néssecaire d'intefier l'utilisateur
#6acfe5>
#6acfe5> document.addEventListener("DOMContentLoaded", async () => {
#6acfe5> const urlParams = new URLSearchParams(window.location.search);
#6acfe5> if (urlParams.has('code') && urlParams.has('username')) {
#6acfe5> try {
#6acfe5> const data_raw = await fetch(`https://auth.axolotl-app.com/verify/?username=${urlParams.get('username')}&code=${urlParams.get('code')}`)
#6acfe5> data = await data_raw.json();
#6acfe5> if (data.status === 'success') {
#6acfe5> console.log("Utilisateur connecté: "+ data.data)
#6acfe5> }
#6acfe5> else if (data.status === 'error') {
#6acfe5> console.log("Authentication échoué: "+ data.data)
#6acfe5> }
#6acfe5> } catch (error) {
#6acfe5> console.error("Authentication échoué: Une erreur inconnu s'est produit");
#6acfe5> }
#6acfe5> }
#6acfe5> });
#6acfe5>
Authentication / Code generator
⬆️