Vimine per sviluppatori

Integra Vimine nel tuo sito

Fai accedere i soci con il loro account Vimine, leggi lo stato della tessera, raccogli richieste di tesseramento, verifica le tessere allo scanner. Un'API REST documentata, un SDK senza dipendenze, una sandbox per ogni associazione.

Inizia Riferimento API

app.js@vimine/sdk

import { Vimine } from '@vimine/sdk';

const vimine = new Vimine({
    clientId: 'vmc_…',
    redirectUri
});

// nella pagina di callback
await vimine.handleRedirect();
const tessera = await vimine.membership.get();
// → { verdict: 'valid', expires_at, card, … }

Validaverdetto dall’API

Accedi con Vimine

OAuth 2.1 con PKCE. La pagina di accesso e consenso è su vimine.network: la password del socio non tocca mai le tue pagine.

API del socio

Profilo, tessera e verdetto (valida, scaduta, statuto da riaccettare), richiesta di tesseramento, accettazione dello statuto, app collegate.

Verifica tessere

Un endpoint pubblico che risponde «attiva / non attiva» senza dati personali, e chiavi pubbliche per verificare i token offline.

Sandbox

Un’associazione gemella con soci sintetici in ogni stato e client di test attivi subito. Reset in un colpo.

Come iniziare

Un direttore dell’associazione apre Sviluppatori nell’app Vimine, registra un client (sito web, app nativa o server) e sceglie i permessi. Un client in ambiente Test è attivo subito nella sandbox.
Installa l’SDK:
Finestra del terminale
```
npm install @vimine/sdk
```

Avvia l’accesso da un click e gestisci il ritorno nella pagina di callback:

import { Vimine } from '@vimine/sdk';

const vimine = new Vimine({ clientId: 'vmc_…', redirectUri: 'https://www.tuosito.it/vimine/callback' });

bottone.addEventListener('click', () => vimine.signIn());

// nella pagina di callback
await vimine.handleRedirect();
const tessera = await vimine.membership.get(); // { status, verdict, expires_at, card: { token }, … }

Guide

Accedi con VimineIl flusso completo, l'SDK, la sessione, l'uscita.

Sandbox e client di testSoci sintetici, credenziali, reset.

Integrazioni serverClient riservati, client_credentials, stato delle tessere.

Permessi, errori e limitiLa tabella degli scope, il formato degli errori, i rate limit.

Embed e verifica tessereIl modulo di tesseramento nel tuo sito e la verifica allo scanner.

Prova l'APILa console interattiva sul documento OpenAPI.