Skip to main content

Personas

Descripción General​

La API de Personas te permite gestionar registros individuales de personas en tu sistema de verificación. Cada registro de persona puede contener información personal, datos biométricos y estado de verificación.

Endpoints de API​

Crear una Persona​

POST https://api.verifik.co/v2/persons

Crear una Persona con Detección de Vida​

POST https://api.verifik.co/v2/persons/liveness

Listar Todas las Personas​

GET https://api.verifik.co/v2/persons

Recuperar una Persona​

GET https://api.verifik.co/v2/persons/{personId}

Actualizar una Persona​

PUT https://api.verifik.co/v2/persons/{personId}

Eliminar una Persona​

DELETE https://api.verifik.co/v2/persons/{personId}

Estructura del Objeto Persona​

### Estructura del Objeto Persona

```json
{
  "id": "person_123456789",
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phone": "+1234567890",
  "dateOfBirth": "1990-01-15",
  "documentType": "passport",
  "documentNumber": "123456789",
  "biometricData": {
    "faceImage": "imagen_codificada_base64",
    "fingerprint": "huella_codificada_base64",
    "livenessScore": 0.95
  },
  "verificationStatus": "verified",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Creando una Persona​

Creación Básica de Persona​


### Creating a Person

#### Basic Person Creation

```javascript
const personData = {
  firstName: "John",
  lastName: "Doe",
  email: "john.doe@example.com",
  phone: "+1234567890",
  dateOfBirth: "1990-01-15",
  documentType: "passport",
  documentNumber: "123456789"
};

const response = await fetch('https://api.verifik.co/v2/persons', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <your_token>'
  },
  body: JSON.stringify(personData)
});

Persona con Detección de Vida​

const personData = {
  firstName: "John",
  lastName: "Doe",
  email: "john.doe@example.com",
  biometricData: {
    faceImage: "imagen_codificada_base64",
    livenessDetection: true
  }
};

const response = await fetch('https://api.verifik.co/v2/persons/liveness', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <your_token>'
  },
  body: JSON.stringify(personData)
});

Estado de Verificación​

  • pending - Persona creada pero aún no verificada
  • verified - Persona ha sido verificada exitosamente
  • failed - Verificación fallida
  • expired - Verificación ha expirado

Casos de Uso​

  • Incorporación de Usuarios: Crea registros de personas durante el registro
  • Almacenamiento Biométrico: Almacena datos biométricos para verificación futura
  • Gestión de Identidad: Mantén una base de datos de individuos verificados
  • Control de Acceso: Usa registros de personas para sistemas de acceso seguro
  • Cumplimiento: Cumple con requisitos regulatorios para verificación de identidad