Saltar al contenido principal

​
Introducción

Identity es un servicio de autenticación proporcionado por Ace Data Cloud para la verificación de identidad con DNI, tarjeta bancaria y número de teléfono móvil. A través de la API unificada de Ace Data Cloud, puedes integrar rápidamente Identity usando JavaScript para realizar OCR de DNI, verificación de DNI, verificación de tarjeta bancaria, verificación de número móvil, entre otras funciones.

​
Requisitos previos

  • Tener una cuenta en Ace Data Cloud y obtener el API Token
  • Node.js 18+ o un entorno de navegador moderno

​
Uso básico

El endpoint principal para llamar a la API de Identity es: 
POST https://api.acedata.cloud/identity/idcard/ocr
Ejemplo completo de código JavaScript: 
const response = await fetch("https://api.acedata.cloud/identity/idcard/ocr", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "image_url": "https://example.com/idcard-front.jpg"
}),
});

const result = await response.json();
console.log(result);
Por favor, reemplaza YOUR_API_TOKEN con el Token real que obtuviste en la plataforma Ace Data Cloud.

​
Manejo de la respuesta

Se recomienda verificar el código de estado de la respuesta y manejar errores: 
if (response.ok) {
  const result = await response.json();
  console.log("Llamada exitosa:", result);
} else {
  console.error(`Llamada fallida, código de estado: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Encapsulación en Node.js

Se recomienda encapsular en una función reutilizable: 
async function callIdentity(data) {
  const response = await fetch("https://api.acedata.cloud/identity/idcard/ocr", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`Error de API: ${response.status}`);
  return response.json();
}

​
Manejo de errores

Códigos de error comunes:
CódigoDescripción
401Autenticación fallida, por favor verifica el API Token
403Saldo insuficiente o acceso denegado
429Límite de frecuencia de solicitudes excedido
500Error interno del servidor

​
Próximos pasos