Este tema describe la API para consultar los resultados de una tarea asíncrona de reconocimiento de credenciales. Antes de llamar a esta API, debe enviar primero una tarea de reconocimiento mediante la API Submit task.
Información de la API
Nombre de la API: CredentialGetResultIntl
Descripción: utiliza inteligencia artificial para extraer información clave de una imagen de credencial o un archivo PDF, y admite la detección de falsificaciones.
Método de solicitud: POST
Protocolo de transporte: HTTPS
-
Límite de QPS: cada API tiene su propio límite de QPS. Para obtener más información, consulte QPS limits of ID Verification server-side APIs.
-
Endpoint:
NotaVentajas del acceso por red interna: una red interna es una red de comunicación privada que conecta los productos de Alibaba Cloud dentro de la misma región. Si su servidor de aplicaciones está desplegado en la misma región, utilice el endpoint interno para acceder al servicio ID Verification. Esto mejora la seguridad y la estabilidad.
Optimización del acceso desde el extranjero: los entornos de red internacionales pueden ser complejos. Consulte Optimize server network latency para ajustar su integración y reducir la latencia de red y las solicitudes con errores.
Asia Pacific SE 1 (Singapore)
Endpoint público:
cloudauth-intl.ap-southeast-1.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com
Depuración e integración en línea
Antes de depurar e integrar, lea el documento Use OpenAPI para aprender cómo llamar a las API en la plataforma OpenAPI y obtener el SDK.
Utilice OpenAPI Explorer para depurar esta API y generar código de ejemplo del SDK.
Parámetros de solicitud
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
|
TransactionId |
String |
Sí |
El identificador único de la tarea. Este valor lo devuelve la API CredentialSubmitIntlV2. |
hksb7ba1b28130d24e015d6**** |
Parámetros de respuesta
Parámetro | Tipo | Descripción | Ejemplo | |
Código de estado HTTP | Integer | El código de estado HTTP. | 200 | |
Cuerpo HTTP | RequestId | String | El identificador de la solicitud. | 130A2C10-B9EE-4D84-88E3-5384FF039**** |
Code | String | El código de retorno. Para obtener más información, consulte Server-side HTTP status codes. Importante
| Success | |
Message | String | El mensaje de respuesta. | success | |
Result.Status | String | El estado de la tarea. Valores válidos:
| SUCCESS | |
Result.SubCode | String | El código del resultado de verificación. Para obtener más información, consulte Error codes for Result.SubCode. | 200 | |
Result.ExtIdInfo | String | Para el formato JSON, consulte el ejemplo de la derecha. Para obtener más información, consulte Result.ExtIdInfo. | Los datos que devuelve esta API dependen del valor del parámetro
| |
Códigos de error para Result.SubCode
|
Código de error |
Facturación |
Descripción |
|
200 |
Sí |
Extracción exitosa. |
|
204 |
Sí |
La información clave no cumplió con las reglas de validación especificadas en CheckRuleConfig. |
|
211 |
Sí |
Calidad o resolución deficiente del archivo. Asegúrese de que el archivo sea nítido, tenga buena exposición, esté completo, sin obstrucciones y sin inclinaciones significativas. |
|
212 |
Sí |
La comprobación contra suplantación detectó un riesgo. Esto puede deberse a indicadores como fotografías de pantalla, alteraciones o fotocopias. |
|
213 |
Sí |
Tipo de archivo incorrecto. Asegúrese de que el tipo de archivo coincida con el parámetro DocType. |
Result.ExtIdInfo
Parámetro | Tipo | Descripción | Ejemplo |
recInfo | String | La información clave extraída, devuelta en formato JSON. Los campos JSON varían según el tipo de credencial. Para obtener más información, consulte Credential field descriptions. Nota Si la extracción falla, este campo queda vacío. | Los datos que devuelve esta API dependen del valor del parámetro
|
spoofInfo | String | El resultado de la comprobación contra suplantación, que incluye la decisión de riesgo y el tipo de riesgo:
| Este resultado se devuelve cuando la detección de alteraciones está habilitada; es decir, cuando el parámetro FraudCheck se establece en true en la solicitud de envío de la tarea. |
Descripciones de los campos de credenciales
Tipo de credencial: certificado de registro de vehículo tailandés (OcrArea=0201)
Información de los campos:
|
Campo |
Tipo |
Descripción |
|
first_registration_date |
String |
Fecha de primer registro |
|
license_number |
String |
Número de placa |
|
registration_province |
String |
Provincia de registro |
|
vehicle_type |
String |
Tipo de vehículo |
|
make |
String |
Marca |
|
model |
String |
Modelo |
|
color |
String |
Color |
|
title_holder |
String |
Titular del título de propiedad |
|
holder_id_number |
String |
Número de identificación del titular |
|
user_name |
String |
Usuario |
|
user_id_number |
String |
Número de identificación del usuario |
|
displacement |
String |
Cilindrada |
|
model_year |
String |
Año del modelo |
|
engine_number |
String |
Número de motor |
|
fuel_type |
String |
Tipo de combustible |
|
seating_capacity |
String |
Capacidad de asientos |
|
engine_specifications |
String |
Especificaciones del motor |
|
VIN |
String |
Número de identificación del vehículo |
|
vehicle_kerb_weight |
String |
Peso en vacío del vehículo |
|
address |
String |
Dirección |
Tipo de credencial: documento de registro de vehículo de Hong Kong (OcrArea=0202)
Información de los campos:
|
Campo |
Tipo |
Descripción |
|
first_registration_date |
String |
Fecha de primer registro |
|
license_number |
String |
Número de placa |
|
registration_province |
String |
Provincia de registro |
|
vehicle_type |
String |
Tipo de vehículo |
|
make |
String |
Marca |
|
model |
String |
Modelo |
|
color |
String |
Color |
|
title_holder |
String |
Titular del título de propiedad |
|
holder_id_number |
String |
Número de identificación del titular |
|
user_name |
String |
Usuario |
|
user_id_number |
String |
Número de identificación del usuario |
|
displacement |
String |
Cilindrada |
|
model_year |
String |
Año del modelo |
|
engine_number |
String |
Número de motor |
|
fuel_type |
String |
Tipo de combustible |
|
seating_capacity |
String |
Capacidad de asientos |
|
engine_specifications |
String |
Especificaciones del motor |
|
VIN |
String |
Número de identificación del vehículo |
|
vehicle_kerb_weight |
String |
Peso en vacío del vehículo |
|
address |
String |
Dirección |
Tipo de credencial: licencia de vehículo de Hong Kong (OcrArea=0204)
Información de los campos:
|
Campo |
Tipo |
Descripción |
|
registration_mark |
String |
Número de registro |
|
year_of_manufacture |
String |
Año de fabricación |
|
date_of_first_registration |
String |
Fecha de primer registro |
|
vehicle_class |
String |
Clase de vehículo |
|
make |
String |
Fabricante o marca |
|
chassis_number |
String |
Número de chasis o número de identificación del vehículo |
|
color |
String |
Color |
|
date_of_expiry |
String |
Fecha de vencimiento de la placa |
|
seating_capacity |
String |
Capacidad de asientos |
|
cylinder_capacity |
String |
Cilindrada |
|
transaction |
String |
Registro archivado |
|
print_date |
String |
Fecha de impresión |