Comment vérifier la validité d'un token Ubiqod Key ?

Comment vérifier la validité d'un token Ubiqod Key ?

Lorsqu'un utilisateur scanne un Ubiqod Key, la plateforme Ubiqod permet de s'assurer que ce scan est bien légitime.

2 cas sont à distinguer : 
  1. Vous utilisez une interface créée sur la plateforme Ubiqod : la validation est effectuée automatiquement
  2. Vous redirigez l'utilisateur vers votre propre interface : un token est envoyé dans l'url, et sa validité peut être vérifiée via une route API 

Ajout du token de validation dans l'url

Pour rediriger les utilisateurs vers votre propre interface, créez une interface de type Redirection:


Saisissez ensuite l'url de votre interface, et cochez la case Jeton de validation :

Info
Nous vous recommandons de cocher Numéro de série du tracker afin de renforcer les vérifications (voir section Vérification de la validité du token)

L'aperçu de l'url (Exemple de redirection) vous permet de prévisualiser les paramètres qui seront ajoutés.

Si vous souhaitez changer le nom du paramètre par défaut, décochez Jeton de validation et ajoutez le paramètre à l'aide des options avancées :


Vérification de la validité du token

Appel API

Il vous appartient de récupérer le contenu du token et le numéro de série de l'Ubiqod Key émetteur à partir des paramètres de l'url redirigée.

Vous pourrez alors vérifier la validité du jeton en appelant la route GET : https://k.ubiqod.com/key/validatetoken 

Comme pour un appel API standard, vous devrez passer votre clef API dans le header, dans une propriété X-API-KEY ({X-API-KEY: <<your-api-key>>})

Le token devra être passé dans le paramètre d'url token (token=<<your-token>>)
Info
Exemple d'url complète (hors header) : https://k.ubiqod.com/key/validatetoken?token=<<your-token>>

Réponse du serveur

En cas de succès, la réponse du serveur sera de la forme (code 200) : 
  1. {
  2.     "tokenData": {
  3.         "creationDate": "2021-02-04T15:10:32.157Z",
  4.         "trackerLabel": "Test device",
  5.         "trackerName": "UK12346"
  6.     }
  7. }
Warning
Nous vous recommandons de vous assurer que le token est valide ET que le trackerName correspond bien au numéro de série de l'Ubiqod Key émetteur.

Si le token n'existe pas, la réponse sera (code 200) : 
  1. {
  2.     "message": "Token not found for this account"
  3. }
Warning
Pour des raisons de performance et de sécurité, le jeton est conservé 24h après son émission : pensez à faire cette validation à réception des données.

En cas d'invalidité de la clef API, une erreur 401 sera retournée.

Si le token n'est pas fourni, une erreur 400 sera retournée.

    Essayez Ubiqod


    Recevez 100 crédits gratuits pour commencer sur Ubiqod: créer un compte

      • Related Articles

      • Activer votre Ubiqod Key

        Introduction Lorsque vous recevez votre Ubiqod Key, l’écran est blanc et les piles ne sont pas insérées. Cette précaution permet d’éviter les phénomènes de rémanence sur l’écran et de préserver l’autonomie des piles pendant le transport. Veuillez ...

      • Ajouter un Ubiqod Key à votre compte Ubiqod

        Introduction Ubiqod Key est un QR code sécurisé et breveté conçu pour des applications nécessitant une sécurité renforcée. Avant de pouvoir l'utiliser sur la plateforme Ubiqod, il est nécessaire de l'ajouter à votre compte. Lors de l'achat d'un ...

      • Introduction à la plateforme Ubiqod

        Ubiqod est une solution simple et flexible pour connecter les actions terrain à vos outils informatiques. La plateforme permet de collecter différentes données (pointages, demandes de service, localisations, enquêtes de satisfaction...) via des QR ...

      • Où puis-je consulter le niveau de piles des Ubiqod Key ?

        Le niveau de piles de vos Ubiqod Key est accessible de deux manières : Directement sur l'appareil Lorsque le niveau de piles devient trop faible, un message d'alerte s'affiche automatiquement sur l'écran de l'Ubiqod Key pour vous indiquer qu'il est ...

      • Ajouter un Ubiqod Key à votre compte Ubiqod

        Introduction Ubiqod Key est un QR code sécurisé et breveté conçu pour des applications nécessitant une sécurité renforcée. Avant de pouvoir l'utiliser sur la plateforme Ubiqod, il est nécessaire de l'ajouter à votre compte. Lors de l'achat d'un ...