Saltar al contenido principal
Este documento presentará una API de verificación de fotos de identificación, que se puede utilizar para enviar fotos de la cara de la identificación, reconocer la información en la foto de la identificación y comparar el nombre, número de identificación y foto de la cara con la foto de identificación en la base de datos autorizada, para verificar si pertenecen a la misma persona, validando así la autenticidad de la información de la identificación.

​
Proceso de solicitud

Para utilizar la API, primero debe ir a la página correspondiente de la API de verificación de fotos de identificación para solicitar el servicio correspondiente. Una vez en 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á utilizar 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 solicitarla.
Además, se configuró el cuerpo de la solicitud, que incluye:
  • image_url: el enlace de la imagen de la identificación que necesita ser procesada.
  • config: opciones de configuración opcionales, campos booleanos, todos predeterminados como false, soporta copy_warn, border_check_warn, reshoot_warn, detect_ps_warn, temp_id_warn, quality (umbral de 0-100).
Después de seleccionar, puede notar que también se generó 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, aquí obtuvimos el siguiente resultado: 
{
  "sim": 99.76,
  "result": "Success",
  "description": "成功",
  "name": "身份证姓名",
  "sex": "身份证性别",
  "nation": "身份证民族",
  "birth": "身份证生日",
  "address": "身份证家庭住址",
  "id_num": "身份证号码",
  "portrait": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBA.....DEhE2lbPMcOtG3f/DLT/yX8if7Kxn/AD7h85wdttPifRf1e6//2Q==",
  "warnings": "",
  "quality": 0,
  "encryption": null
}
El resultado devuelto tiene varios campos, que se describen a continuación:
  • sim, similitud, rango de valores [0.00, 100.00]. Se recomienda que una similitud mayor o igual a 70 se considere como la misma persona, y puede ajustar el umbral según el escenario específico (la tasa de error de un umbral de 70 es de uno en mil, y la tasa de error de un umbral de 80 es de uno en diez mil).
  • result, código de error de negocio, en caso de éxito devuelve Success, en caso de error consulte la sección de códigos de error en la lista de FailedOperation a continuación.
  • description, resultado de la verificación del nombre y 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.
  • sex, información de género en la identificación, si no se ha subido la imagen de la identificación, estará vacío.
  • nation, información de nacionalidad en la identificación, si no se ha subido la imagen de la identificación, estará vacío.
  • birth, información de 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 dirección en la identificación, si no se ha subido la imagen de la identificación, estará vacío.
  • id_num, 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.
  • portrait, codificación base64 de la foto de la cara de la identificación, si la extracción de la imagen falla, se comparará con la imagen completa de la identificación y se devolverá vacío.
  • warnings, información de advertencia, cuando se configura información de advertencia en Config, se detendrá la comparación de imágenes y el resultado devolverá un error (FailedOperation.OcrWarningOccurred) y tendrá esta información de advertencia.
  • quality, puntaje de calidad de la imagen, cuando se configura la advertencia de imagen borrosa en la solicitud, este parámetro tiene sentido, rango de valores (0-100), actualmente el umbral predeterminado es 50, por debajo de 50 se activará la advertencia de borrosidad.
  • encryption, información de cifrado de datos sensibles.
Se puede ver que la información de la identificación tiene una alta autenticidad. Además, si desea generar el código de integración correspondiente, puede copiarlo directamente, por ejemplo, el código CURL es el siguiente: 
curl -X POST 'https://api.acedata.cloud/identity/idcard/check-1e' \
-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/check-1e"

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)

​
Manejo de errores

Al llamar a la API, si encuentra 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 superado 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 utilizar la API de verificación de fotos de identificación para enviar fotos de la cara de la identificación, reconocer la información en la foto de la identificación y comparar el nombre, número de identificación y foto de la cara con la foto de identificación en la base de datos autorizada, para verificar si pertenecen a la misma persona, validando así la autenticidad de la información de la 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.