Aller au contenu

Vimine pour les développeurs

Intégrez Vimine à votre site

Laissez les membres se connecter avec leur compte Vimine, lisez l’état de leur carte, recueillez les demandes d’adhésion, vérifiez les cartes à l’entrée. Une API REST documentée, un SDK sans dépendances, une sandbox pour chaque association.

Se connecter avec Vimine

OAuth 2.1 avec PKCE. La page de connexion et de consentement se trouve sur vimine.network : le mot de passe du membre ne passe jamais par vos pages.

API membre

Profil, carte et verdict (valable, expirée, statuto à accepter de nouveau), demandes d’adhésion, acceptation du statuto, applications connectées.

Vérification des cartes

Un endpoint public qui répond « active / non active » sans aucune donnée personnelle, et des clés publiques pour vérifier les jetons hors ligne.

Sandbox

Une association jumelle avec des membres synthétiques dans tous les états et des clients de test actifs immédiatement. Réinitialisée d’un coup.

  1. Un dirigeant de l’association ouvre Développeurs dans l’application Vimine, enregistre un client (site web, application native ou serveur) et choisit les autorisations. Un client de l’environnement Test est actif immédiatement dans la sandbox.

  2. Installez le SDK :

    Fenêtre de terminal
    npm install @vimine/sdk
  3. Lancez la connexion depuis un clic et traitez le retour sur la page de callback :

    app.js
    import { Vimine } from '@vimine/sdk';
    const vimine = new Vimine({ clientId: 'vmc_…', redirectUri: 'https://www.example.org/vimine/callback' });
    button.addEventListener('click', () => vimine.signIn());
    // sur la page de callback
    await vimine.handleRedirect();
    const card = await vimine.membership.get(); // { status, verdict, expires_at, card: { token }, … }