Interfaçage API - Vérification d'un annuaire utilisateur (LDAP)

Interfaçage API - Vérification d'un annuaire utilisateur (LDAP)

La mise en place de la vérification des adresses email par une API fait l'objet d'une prestation spécifique.

Présentation

Afin de vérifier l’existence d'un utilisateur, nous pouvons nous interfacer avec une API qui nous informe de la validité de l'adresse mail renseignée. Pour ce faire, nous interrogeons un service web HTTP(S) en POST avec un header "X-Token" pour autoriser seulement notre service à interroger votre API et deux paramètres "mail" et "resource_id" dans le body de la requête contenant l'adresse mail à vérifier. Le service web répond en JSON avec un booléen (true/false) "user_valid".

Processus

En synthèse, voici le processus étape par étape :

  1. Un utilisateur effectue une réservation sur le site web ou sur l'application mobile
  2. Nous construisons une requête pour vérifier l'adresse mail renseignée :
    1. Protocole : HTTP ou HTTPS
    2. URL : URL que vous nous communiquerez
    3. Header : X-Token : token que vous générez
    4. Body :
  1. {
  2. "mail" : "user@mail.com",
  3. “resource_id” : 123
  4. }

Exemple de requête curl :

  1. curl -X POST \
  2.   https://validation-url.com/ \
  3.   -H "Accept: application/json" \
  4.   -H "Content-Type: application/json" \
  5.   -H "X-Token: random-token" \
  6.   -d '{
  7.     "mail" : "utilisateur@etablissement.com",
  8.     “resource_id” : 123
  9.   }'

Réponse

En fonction du résultat (adresse existante, utilisateur valide, ...), le service web renvoie une réponse :

  • Si l'utilisateur est valide : {"user_valid":true}
  1. {
  2. “user_valid” : true
  3. }
  • Si l'utilisateur n'est pas valide
  1. {
  2. “user_valid” : false
  3. }
 

    • Related Articles

    • API : intégration web et personnalisation

      Introduction Par le terme “WebAPI”, nous parlons de différents modules à intégrer au code dans une page web pour permettre d’afficher sous forme de widget web : L’affluence en temps réel de l’établissement (taux d'occupation ou temps d'attente) Les ...

    • Questionnaire technique d’installation du connecteur logiciel

      Ces questions techniques élaborées par notre service informatique permettent de définir les conditions d’installation du connecteur logiciel.   Récupération de l'historique de fréquentation Les informations “entrées et sorties” ou “visiteurs ...

    • Visualiser les réservations de plusieurs ressources sur un même calendrier

      L'onglet Réservations > Gérer le planning permet d'avoir une visibilité des réservations faites pour une ressource sélectionnée. Vous pouvez visualiser un planning des réservations effectuées pour une ou plusieurs ressources en important le ...

    • Présentation des plateformes d’Affluences (application mobile et site web)

      Application mobile Affluences L’application Affluences est téléchargeable depuis le Play Store ou l’Apple Store, est gratuite et sans publicité. Lors de la première connexion, il est possible d’accepter la géolocalisation ce qui permettra d'afficher ...

    • Installation d'un compteur infrarouge avec un collecteur 3G

      L’équipe Affluences reste disponible tout au long du processus de mise en place du matériel. N’hésitez pas à nous contacter par mail à l’adresse support@affluences.com Matériel 2 boîtiers de comptage à faisceau infrarouge 1 boîtier collecteur 3G de ...