Vimine para desarrolladores

Integra Vimine en tu sitio web

Permite que los socios inicien sesión con su cuenta de Vimine, consulta el estado de su carné, recoge solicitudes de inscripción, verifica los carnés en la entrada. Una API REST documentada, un SDK sin dependencias, un sandbox para cada asociación.

Empezar Referencia de la API

app.js@vimine/sdk

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

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

// en la página de callback
await vimine.handleRedirect();
const card = await vimine.membership.get();
// → { verdict: 'valid', expires_at, card, … }

Válidoveredicto de la API

Iniciar sesión con Vimine

OAuth 2.1 con PKCE. La página de inicio de sesión y de consentimiento está en vimine.network: la contraseña del socio nunca pasa por tus páginas.

API de socios

Perfil, carné y veredicto (válido, caducado, estatuto por volver a aceptar), solicitudes de inscripción, aceptación del estatuto, apps conectadas.

Verificación de carnés

Un endpoint público que responde «activo / no activo» sin datos personales, y claves públicas para verificar los tokens sin conexión.

Sandbox

Una asociación gemela con socios sintéticos en todos los estados y clientes de prueba activos al instante. Se restablece de una vez.

Cómo empezar

Un miembro de la junta directiva de la asociación abre Desarrolladores en la app de Vimine, registra un cliente (sitio web, app nativa o servidor) y elige los permisos. Un cliente del entorno Test queda activo de inmediato en el sandbox.
Instala el SDK:
Ventana de terminal
```
npm install @vimine/sdk
```

Lanza el inicio de sesión desde un clic y gestiona la vuelta en la página de callback:

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

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

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

// en la página de callback
await vimine.handleRedirect();
const card = await vimine.membership.get(); // { status, verdict, expires_at, card: { token }, … }

Guías

Iniciar sesión con VimineEl flujo completo, el SDK, la sesión, el cierre de sesión.

Sandbox y clientes de pruebaSocios sintéticos, credenciales, restablecimiento.

Integraciones de servidorClientes confidenciales, client_credentials, estado de los carnés.

Permisos, errores y límitesLa tabla de scopes, el formato de los errores, los límites de frecuencia.

Integración y verificación de carnésEl formulario de inscripción en tu sitio y la verificación en la entrada.

Prueba la APILa consola interactiva sobre el documento OpenAPI.