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/número de teléfono móvil. A través de la API unificada de Ace Data Cloud, puedes integrar rápidamente Identity usando Python para realizar OCR de DNI, verificación de DNI, verificación de tarjeta bancaria, verificación de número de teléfono móvil, entre otras funciones.

​
Requisitos Previos

  • Tener una cuenta en Ace Data Cloud y obtener el API Token
  • Entorno Python 3.7 o superior
  • Instalar la librería requests: pip install requests

​
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 Python: 
import requests

url = "https://api.acedata.cloud/identity/idcard/ocr"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "image_url": "https://example.com/idcard-front.jpg"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Por favor, reemplaza YOUR_API_TOKEN con el Token real que obtuviste en la plataforma Ace Data Cloud.

​
Manejo de Respuestas

Después de una llamada exitosa, la API devuelve datos en formato JSON. Se recomienda verificar el código de estado HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Llamada exitosa:", result)
else:
    print(f"Llamada fallida, código de estado: {response.status_code}")
    print(response.text)

​
Uso Avanzado

Para APIs que soportan tareas asíncronas, puedes obtener resultados mediante una URL de callback: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# El resultado será enviado a tu servidor a través de la URL de callback

​
Manejo de Errores

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

​
Otros Endpoints

El servicio Identity también ofrece los siguientes endpoints:
  • POST https://api.acedata.cloud/identity/idcard/check-1e
  • POST https://api.acedata.cloud/identity/bankcard/check-1e
  • POST https://api.acedata.cloud/identity/phone/check-1e

​
Próximos Pasos