Todos los productos
Search
Centro de documentos

ID Verification:Query results

Última actualización: Nov 05, 2026

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:

    Nota
    • Ventajas 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.com

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

Depuración e integración en línea

Nota

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
  • Este parámetro indica si la llamada a la API fue exitosa.

  • Para conocer el resultado de la verificación, revise los campos del objeto Result.

Success

Message

String

El mensaje de respuesta.

success

Result.Status

String

El estado de la tarea. Valores válidos:

  • PROCESSING: la tarea está en curso. Continúe con el sondeo.

  • SUCCESS: la tarea se completó de forma exitosa.

  • FAILED: la tarea finalizó con errores.

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 OcrArea especificado en la solicitud Submit task. Las reglas son las siguientes:

  • Si el parámetro de solicitud OcrArea se establece en 0101:

    {
          // When tampering detection is enabled (FraudCheck = true), spoofInfo is returned.
          "spoofInfo":
          {
            "spoofResult": "Y",
            "spoofType": ["PS", "SCREEN_PHOTO", "ORIGINAL_PHOTO"]
          },
          "recInfo":
          {
            "address": "Yingfeng Subdistrict, Xiaoshan District, Hangzhou City, Zhejiang Province***",
            "name": "Zhang San"
          }
        }
  • Si el parámetro de solicitud OcrArea se establece en 0301:

    {
          // When tampering detection is enabled (FraudCheck = true), spoofInfo is returned.
          "spoofInfo":
          {
            "spoofResult": "Y",
            "spoofType": ["PS", "SCREEN_PHOTO", "ORIGINAL_PHOTO"]
          },
          "recInfo":
          {
            "money": "$41.41"
          }
        }
  • Si el parámetro de solicitud OcrArea se establece en 0401:

    {
          "translateInfo": {
            "address_t": "1/176-C China",
            "name_t": "SSS SSS SSS"
          },
          "standardInfo": {
            "date_of_issue_s": "2010-06-05"
          },
          "spoofInfo": {
            "spoofResult": "Y",
            "spoofType": ["PS", "SCREEN_PHOTO", "ORIGINAL_PHOTO"]
          },
          "checkInfo": {
            "address_rule": "Y",
            "date_of_issue_rule": "Y",
            "name_rule": "Y"
          },
          "recInfo": {
            "address": "1/176-C China",
            "date_of_issue": "06/05/2010",
            "name": "SSS SSS SSS"
          }
        }

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 OcrArea especificado en la solicitud Submit task. Las reglas son las siguientes:

  • Si el parámetro de solicitud OcrArea se establece en 0101:

    {
          "address": "Yingfeng Subdistrict, Xiaoshan District, Hangzhou City, Zhejiang Province***",
          "name": "Zhang San"
        }
  • Si el parámetro de solicitud OcrArea se establece en 0202:

     "recInfo":
          {
            "Registration Mark": "PV5721"  
          }
  • Si el parámetro de solicitud OcrArea se establece en 0301:

    {
          "money": "$41.41"
        }

spoofInfo

String

El resultado de la comprobación contra suplantación, que incluye la decisión de riesgo y el tipo de riesgo:

  • spoofResult:

    • Y: se detectó un riesgo.

    • N: no se detectaron riesgos.

  • spoofType:

    • PS: edición de imagen.

    • SCREEN_PHOTO: fotografía de una pantalla.

    • SCREENSHOT: captura de pantalla.

    • ORIGINAL_PHOTO: imagen no original.

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.

{
  "spoofResult": "Y",
  "spoofType": [
    "PS"
  ]
}

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