Skip to content

Connecteurs navigateur ‐ serveur

Rotomeca edited this page Oct 17, 2023 · 4 revisions

Les connecteurs se trouvent dans le fichier connectors.js.

Utiliser un connecteur

Dans un module

import {BnumConnector} from "...path"
const data = await BnumConnector.connect(BnumConnector.connectors.defined_connector, {})

if (BnumConnector.is_on_progress(data)) throw new Error('Le connecteur n\'est pas encore implémenté !', 1);
else dosomething(data);

Dans du js classique

const BnumConnector = await module_helper_mel.BnumConnector();

let config = BnumConnector.connectors.settings_da_set_email_recup.needed;
let datas = await BnumConnector.connect(BnumConnector.connectors.settings_da_send_otp_token, {
     params:config,
});

if (BnumConnector.is_on_progress(data)) throw new Error('Le connecteur n\'est pas encore implémenté !', 1);
else dosomething(data);

BnumConnector

connect

await BnumConnector.connect(connector, {params, default_return})
Permet de se connecteur à un connecteur. Celui-ci est défini par connector.
params correspond aux paramètres supplémentaires (pour un post par exemple).
default_return valeur par défaut si la valeur retournée est null ou undefined

Les données récupérés sont sous cette forme :

{
datas:*,
has_error:boolean,
error:string | Array | *
}

force_connect

await BnumConnector.force_connect(connector, {params, default_return})
Fait exactement la même chose que connect mais renvoie la valeur par défaut si il y a une erreur au lieu d'envoyé un objet.

is_on_progress

BnumConnector.is_on_progress(data)
data => Données retournées pas connect
Vérifie si les données proviennent d'un connecteur pas encore implémenté.

connectors

BnumConnector.connectors La liste des connecteurs. A utiliser pour connect ou force_connect.

Connecteurs

Double authentification

settings_da_get_email_recup

await BnumConnector.connect(BnumConnector.connectors.settings_da_get_email_recup, {})
Récupère l'email de récupération de la double authentification.

  • Paramètres demandés : /
  • Type : get
  • Données de retour : string

settings_da_get_email_valid

await BnumConnector.connect(BnumConnector.connectors.settings_da_get_email_valid, {})
Récupère si l'adresse email a été validée ou non

  • Paramètres demandés : /
  • Type : get
  • Données de retour : boolean

settings_da_set_email_recup

await BnumConnector.connect(BnumConnector.connectors.settings_da_set_email_recup, {params:{_val:string, _send_mail:boolean})
Sauvegarde l'adresse email de récupération et envoie le mail de validation

  • Paramètres demandés :
    • _val => adresse email qui sera stockée
    • _send_mail => Envoie l'email avec le code de vérification, true par défaut
  • Type : post
  • Données de retour : {set:*, sent:bool}

settings_da_set_token_otp

await BnumConnector.connect(BnumConnector.connectors.settings_da_set_token_otp, {params:{_token:string}})

  • Paramètres demandés :
    • _token => Token qui provient de l'adresse email
  • Type : post
  • Données de retour :
    • -1 => Le token a éxpiré
    • 0 => Le token n'est pas bon
    • 1 => Token bon, pas expiré et adresse de récupération validée et sauvegardée

settings_da_send_otp_token

await BnumConnector.connect(BnumConnector.connectors.settings_da_send_otp_token, {})
Envoi l'adresse email de récupération

  • Paramètres demandés : /
  • Type : post
  • Données de retour : boolean