Puntaje de Vitalidad

Endpoint

POST https://api.verifik.co/v2/face-recognition/liveness-score

Devuelve un puntaje de vitalidad y un resultado de aprobado/rechazado para una imagen facial usando el stack de detección de ataques de presentación (PAD) de Verifik. Úsalo cuando necesites el contrato de vitalidad enfocado en el puntaje.

Estabilidad de la API: Este es un endpoint público de producción. Los contratos de solicitud y respuesta siguen la política estándar de cambios y deprecación de Verifik. La facturación usa el mismo AppFeature que POST /v2/face-recognition/liveness.

vs /liveness

	POST .../liveness	POST .../liveness-score
Uso	Detección de vitalidad estándar	Respuesta de vitalidad enfocada en el puntaje
Facturación	AppFeature de liveness	El mismo AppFeature (ruta reescrita para créditos)
Cuerpo	os, image, opcionales collection_id, liveness_min_score	Igual

Detección de ataques de presentación (PAD)

La vitalidad facial de Verifik (incluido este endpoint y /liveness) usa nuestro stack biométrico con detección de ataques de presentación (PAD). La vitalidad está certificada iBeta Level 2 y alineada con ISO 30107 Level 1 y Level 2. Está diseñada para detectar vectores de spoofing comunes como fotos impresas, reproducción de video y máscaras 3D, mediante una verificación de vitalidad de una sola imagen.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Parámetros

Name	Type	Required	Description
os	string	Sí	Origen de captura. Sugerido: DESKTOP, IOS, ANDROID.
image	string	Sí	Datos de imagen Base64 (data URI o base64 crudo). Si se proporciona una URL https, será descargada y convertida internamente.
collection_id	string	No	Colección opcional para asociar con el intento de vitalidad.
liveness_min_score	number	No	Umbral para aprobado/rechazado. Por defecto: 0.6.

Solicitud

Node.js

const fetch = require("node-fetch");

async function run() {
  const res = await fetch("https://api.verifik.co/v2/face-recognition/liveness-score", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
    },
    body: JSON.stringify({
      os: "DESKTOP",
      image: "<base64 or https url>",
      liveness_min_score: 0.6,
    }),
  });
  console.log(await res.json());
}

run();

PHP

<?php
$ch = curl_init("https://api.verifik.co/v2/face-recognition/liveness-score");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Authorization: Bearer " . getenv("VERIFIK_TOKEN")
]);
$body = json_encode([
    "os" => "DESKTOP",
    "image" => "<base64 or https url>",
    "liveness_min_score" => 0.6
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Python

import os, requests

url = "https://api.verifik.co/v2/face-recognition/liveness-score"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"
}
payload = {
    "os": "DESKTOP",
    "image": "<base64 or https url>",
    "liveness_min_score": 0.6
}
r = requests.post(url, json=payload, headers=headers)
print(r.json())

Go

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    payload := map[string]interface{}{
        "os": "DESKTOP",
        "image": "<base64 or https url>",
        "liveness_min_score": 0.6,
    }
    b, _ := json.Marshal(payload)
    req, _ := http.NewRequest("POST", "https://api.verifik.co/v2/face-recognition/liveness-score", bytes.NewBuffer(b))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer "+os.Getenv("VERIFIK_TOKEN"))
    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    var out map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&out)
    fmt.Println(out)
}

Respuesta

200

{
  "id": "JQ4RM",
  "data": {
    "passed": true,
    "min_score": 0.6,
    "liveness_score": 0.98
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "January 16, 2024 3:44 PM"
  }
}

401/403

{
  "message": "Authentication required",
  "code": "UNAUTHORIZED"
}

o

{
  "message": "token_expired",
  "code": "FORBIDDEN"
}

409

{
  "message": "\"os\" is required",
  "code": "MissingParameter"
}

500

{
  "message": "internal_error",
  "code": "ERROR"
}

Notas

• Asegura Authorization: Bearer <token>; de lo contrario recibirás 401/403.
• image puede ser base64 o una URL https. Si es URL, el servicio la descarga y convierte internamente.
• Aprobado/rechazado se determina con liveness_score > min_score (por defecto min_score es 0.6, configurable con liveness_min_score).
• Los créditos se cobran contra el mismo feature que /liveness.
• El collection_id opcional se valida para el cliente autenticado.