Skip to main content
Este documento presentará una integración de la API de verificación de información de identidad y validez, que se puede utilizar para verificar la autenticidad y consistencia del nombre, número de identificación y la validez de la identificación.

​
Proceso de solicitud

Para utilizar la API de verificación de información de identidad y validez, primero dirígete a Ace Data Cloud Console para obtener tu API Token, que debes guardar como respaldo. Si aún no has iniciado sesión o registrado, serás redirigido automáticamente a la página de inicio de sesión que te invitará a registrarte e iniciar sesión, y después volverás automáticamente a la página actual. Un API Token es suficiente para acceder a todos los servicios de la plataforma, no es necesario solicitar uno para cada servicio. La primera solicitud incluirá un crédito gratuito para que puedas probarlo; si el crédito es insuficiente, puedes recargar el saldo general en la consola.
📘 Documentación completa: API de verificación de información de identidad y validez →

​
Uso básico

Primero, debes entender la forma básica de uso, que consiste en ingresar el enlace de la imagen de la identificación, y así obtener el resultado de verificación procesado. Primero, necesitas pasar un campo name, y luego puedes completar el contenido correspondiente en la interfaz, como se muestra en la imagen:

Puedes ver que aquí hemos configurado los Request Headers, que incluyen:
  • accept: el formato de respuesta que deseas recibir, aquí se establece como application/json, es decir, formato JSON.
  • authorization: la clave para llamar a la API, que puedes seleccionar directamente después de solicitarla.
Además, se ha configurado el Request Body, que incluye:
  • name: nombre.
  • id_card: número de identificación.
  • image_url: enlace de la imagen facial que necesita ser procesada.
  • validity_end: fecha de caducidad de la identificación, formato: YYYYMMDD, usar “00000000” para largo plazo;
  • validity_begin: fecha de inicio de validez de la identificación, formato: YYYYMMDD.
  • encryption: opcional, parámetros de cifrado para campos sensibles (si se necesita enviar encriptado).
Después de seleccionar, puedes notar que también se ha generado el código correspondiente a la derecha, como se muestra en la imagen:

Haz clic en el botón “Try” para realizar la prueba, como se muestra en la imagen anterior, aquí hemos obtenido el siguiente resultado:
El resultado devuelto tiene varios campos, que se describen a continuación:
  • result, código de resultado de autenticación, la situación de cobro es la siguiente.
    • Códigos de resultado de cobro:
      • 0: Nombre y número de identificación coinciden
      • -1: Nombre y número de identificación no coinciden
    • Códigos de resultado sin cobro:
      • -2: Número de identificación ilegal (longitud, dígito de verificación, etc. incorrectos)
      • -3: Nombre ilegal (longitud, formato, etc. incorrectos)
      • -4: Excepción en el servicio de base de datos de documentos
      • -5: No hay registro de este número de identificación en la base de datos
      • -6: Sistema de comparación autoritativa en actualización, por favor inténtalo más tarde
      • -7: Número de autenticaciones excede el límite diario.
  • description, resultado de la verificación del nombre y número de identificación.
Se puede ver que el nombre, número de identificación y la validez de la identificación tienen autenticidad y consistencia. Además, si deseas generar el código de integración correspondiente, puedes copiarlo directamente, por ejemplo, el código de CURL es el siguiente:
El código de integración en Python es el siguiente:

​
Manejo de errores

Al llamar a la API, si encuentras un error, la API devolverá el código de error y la información correspondiente. Por ejemplo:
  • 400 token_mismatched: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 400 api_not_implemented: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 401 invalid_token: No autorizado, token de autorización inválido o faltante.
  • 429 too_many_requests: Demasiadas solicitudes, has superado el límite de tasa.
  • 500 api_error: Error interno del servidor, algo salió mal en el servidor.

​
Ejemplo de respuesta de error

​
Conclusión

A través de este documento, ya has comprendido cómo utilizar la API de verificación de información de identidad y validez para verificar la autenticidad y consistencia del nombre, número de identificación y validez de la identificación. Esperamos que este documento te ayude a integrar y utilizar mejor esta API. Si tienes alguna pregunta, no dudes en contactar a nuestro equipo de soporte técnico.