Saltar al contenido principal
Este documento presentará una API de reconocimiento de identificación y verificación de información, que puede verificar la autenticidad y consistencia del nombre y el número de identificación ingresando una imagen de la identificación o el nombre y el número de identificación. Esta interfaz se utiliza para verificar la autenticidad y consistencia del nombre y el número de identificación, y puede proporcionar la información de verificación requerida ingresando el nombre y el número de identificación o enviando una foto del rostro de la identificación.

​
Proceso de solicitud

Para usar la API, primero debe ir a la página correspondiente de la API de reconocimiento de identificación y verificación de información para solicitar el servicio correspondiente. Después de ingresar a la página, haga clic en el botón “Acquire”, como se muestra en la imagen: Si aún no ha iniciado sesión o registrado, será redirigido automáticamente a la página de inicio de sesión que lo invita a registrarse e iniciar sesión. Después de registrarse e iniciar sesión, será redirigido automáticamente a la página actual. En la primera solicitud, se le otorgará un límite gratuito que le permitirá usar la API de forma gratuita.

​
Uso básico

Primero, comprenda la forma básica de uso, que consiste en ingresar el enlace de la imagen de la identificación para obtener el resultado de verificación procesado. Primero, necesita pasar un campo image_url, y luego podemos completar el contenido correspondiente en la interfaz, como se muestra en la imagen:

Aquí podemos ver que hemos configurado los encabezados de la solicitud, que incluyen:
  • accept: el formato de respuesta que desea recibir, aquí se establece como application/json, es decir, formato JSON.
  • authorization: la clave para llamar a la API, que puede seleccionar directamente después de solicitar.
Además, se ha configurado el cuerpo de la solicitud, que incluye:
  • image_url: el enlace de la imagen de la identificación que necesita ser procesada.
  • encryption: opcional, parámetro de cifrado de campos sensibles (si se necesita enviar encriptado).
Después de seleccionar, también se generará el código correspondiente a la derecha, como se muestra en la imagen:

Haga clic en el botón “Try” para realizar la prueba, como se muestra en la imagen anterior, y obtendremos el siguiente resultado: 
{
  "result": "0",
  "description": "Nombre y número de identificación coinciden",
  "name": "Nombre en la identificación",
  "id_card": "Número de identificación",
  "sex": "Sexo en la identificación",
  "nation": "Nacionalidad en la identificación",
  "birth": "Fecha de nacimiento en la identificación",
  "address": "Dirección en la identificación"
}
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 intente más tarde
      • -7: Número de autenticaciones excede el límite diario.
  • description, resultado de la verificación del nombre y el número de identificación.
  • name, información del nombre en la identificación, si no se ha subido la imagen de la identificación, estará vacío.
  • id_card, información del número de identificación en la identificación, si no se ha subido la imagen de la identificación, estará vacío.
  • sex, información del sexo en la identificación, si no se ha subido la imagen de la identificación, estará vacío.
  • nation, información de la nacionalidad en la identificación, si no se ha subido la imagen de la identificación, estará vacío.
  • birth, información de la fecha de nacimiento en la identificación, si no se ha subido la imagen de la identificación, estará vacío.
  • address, información de la dirección en la identificación, si no se ha subido la imagen de la identificación, estará vacío.
Se puede ver que la información del nombre y el número de identificación en la identificación es consistente y válida, y también se ha utilizado tecnología OCR para extraer y mostrar otra información. Además, si desea generar el código de integración correspondiente, puede copiarlo directamente, por ejemplo, el código de CURL es el siguiente: 
curl -X POST 'https://api.acedata.cloud/identity/idcard/ocr' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": {image_url}
}'
El código de integración en Python es el siguiente: 
import requests

url = "https://api.acedata.cloud/identity/idcard/ocr"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image_url": {image_url}
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
Verificación de información personalizada

También ofrecemos una forma de verificación que no revela la información de la imagen de la identificación, que solo requiere ingresar el nombre name y el número de identificación id_card para verificar la autenticidad y consistencia del nombre y el número de identificación. A continuación se muestran los detalles de la información ingresada:

Después de hacer clic en ejecutar, se obtiene el siguiente resultado: 
{
    "address": "",
    "birth": "",
    "description": "Nombre y número de identificación coinciden",
    "id_card": "Número de identificación",
    "name": "Nombre en la identificación",
    "nation": "",
    "result": "0",
    "sex": ""
 }
De esta manera, el resultado no revelará otra información privada, y también se puede completar la verificación de la autenticidad y consistencia del nombre y el número de identificación.

​
Manejo de errores

Al llamar a la API, si se encuentra con 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, ha excedido el límite de tasa.
  • 500 api_error: Error interno del servidor, algo salió mal en el servidor.

​
Ejemplo de respuesta de error

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Conclusión

A través de este documento, ha aprendido cómo usar la API de reconocimiento de identificación y verificación de información para verificar la autenticidad y consistencia del nombre y el número de identificación ingresando una imagen o información del nombre y número de identificación. Esperamos que este documento le ayude a integrar y utilizar mejor esta API. Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de soporte técnico.