Primeros pasos
Bienvenido a la Documentación para desarrolladores de Heuristik. Esta guía te ayudará a integrar la verificación de identidad en tu aplicación.
Elige tu integración
| Método | Ideal para | Esfuerzo |
|---|---|---|
| Iframe | Integración rápida, UI alojada | Bajo |
| JavaScript SDK | Control total, UI personalizada | Medio |
| API REST | Servidor a servidor, cualquier lenguaje | Alto |
Visión general
Requisitos previos
Antes de empezar
Necesitas una cuenta de Heuristik y una clave API. Regístrate en dashboard.heuristik.com.
- Una clave API de Heuristik (live o sandbox)
- Node.js 20+ (para el JavaScript SDK)
- HTTPS habilitado en tu dominio
Instalación
- npm
- yarn
- pnpm
npm install @heuristik/sdk
yarn add @heuristik/sdk
pnpm add @heuristik/sdk
Primera verificación
app.ts
import { HeuristikClient } from '@heuristik/sdk';
const client = new HeuristikClient({
apiKey: 'sk_sandbox_tu_clave_aqui',
});
const session = await client.createSession({
referenceId: 'user-12345',
redirectUrl: 'https://tuapp.com/callback',
});
console.log('Token de sesión:', session.token);
¿Qué sigue?
Ve a la integración con Iframe para la configuración más rápida, o profundiza en el JavaScript SDK para control total.
Sandbox vs Producción
Usa siempre claves sandbox (sk_sandbox_*) durante el desarrollo. Las claves de producción (sk_live_*) procesan verificaciones reales.
Límites de peticiones
La API aplica límites de 100 peticiones por minuto por clave API. Consulta Manejo de errores para más detalles.