Todos los productos
Search
Centro de documentos

ID Verification:Envío de una tarea

Última actualización: Oct 29, 2026

Este tema describe cómo enviar una tarea de reconocimiento al servicio asíncrono de detección de credenciales. Llamar a esta API es el primer paso para usar el servicio asíncrono.

Información de la API

  • Nombre de la operación: CredentialSubmitIntlV2

  • Descripción: envíe una tarea de reconocimiento al servicio asíncrono de detección de credenciales.

  • 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.

  • Endpoints:

    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, use el endpoint interno para acceder al servicio ID Verification y mejorar 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, reducir la latencia de la red y disminuir los errores en las solicitudes.

    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

Nota
  1. La función de detección de falsificaciones es un producto de predicción basado en inteligencia artificial. Alcanza un 90 % de precisión en los conjuntos de datos de prueba internos. La precisión real puede variar debido a las diferencias en los escenarios reales.

  2. La detección de falsificaciones funciona mejor con imágenes capturadas por una cámara que con imágenes sintetizadas o alteradas digitalmente.

  3. No dependa de la detección de falsificaciones como único método para verificar la autenticidad de una credencial. Úsela como complemento de la revisión manual o como herramienta para mejorar la eficiencia de dicha revisión.

  4. Esta función se usa ampliamente para revisar materiales electrónicos en escenarios como la adquisición de pagos financieros y el registro de comercios de comercio electrónico, lo que mejora de forma efectiva la eficiencia de la revisión manual. Si necesita usarla en otros escenarios, comuníquese con su gerente de cuenta.

Depuración e integración en línea

Nota

Antes de depurar e integrar, lea el documento Use OpenAPI para aprender a llamar a las API en la plataforma OpenAPI y obtener el SDK.

Use OpenAPI Explorer para depurar esta operación y generar automáticamente ejemplos de código del SDK.

Parámetros de solicitud

El archivo correspondiente al parámetro CredentialOcrPictureBase64, CredentialOcrPictureUrl o CredentialOcrPictureFile debe cumplir con los siguientes requisitos:

  • Método de envío: elija uno de los tres métodos de carga.

  • Formato de archivo: cuando FileInputType=IMAGE (valor predeterminado), los formatos compatibles son PNG, JPG, JPEG, BMP y WebP. Cuando FileInputType=PDF, el formato compatible es PDF.

  • Dimensiones del archivo: tanto el ancho como el alto deben ser mayores a 15 píxeles y menores a 8192 píxeles. La relación de aspecto debe ser menor a 50.

  • Tamaño del archivo: no puede superar los 10 MB.

Nota
  • Para obtener resultados de reconocimiento óptimos, se recomienda que tanto el ancho como el alto de la imagen sean mayores a 500 píxeles.

  • Los archivos grandes aumentan el tiempo de respuesta de la API. Se recomienda usar archivos menores a 3 MB.

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

ProductCode

String

Sí

Establezca el valor en CREDENTIAL_RECOGNITION.

CREDENTIAL_RECOGNITION

SceneCode

String

No

Identificador personalizado del escenario de autenticación. Puede usar este identificador para consultar los registros relacionados en la consola. Admite hasta 10 letras, dígitos y guiones bajos (_).

1234567890

MerchantBizId

String

Sí

Identificador de negocio único y personalizado que se usa para solucionar problemas. Puede contener hasta 32 letras y dígitos. Asegúrese de que el identificador sea único.

Nota

Alibaba Cloud no exige que este parámetro sea único. Para lograr una mejor trazabilidad, se recomienda encarecidamente usar un identificador distinto para cada solicitud.

-

CredentialOcrPictureBase64

String

No. Use solo uno de los tres parámetros para cargar el archivo.

Contenido codificado en Base64 de la imagen o del archivo PDF. Si usa este parámetro, asegúrese de que el archivo no supere el límite de tamaño.

base64

CredentialOcrPictureUrl

String

URL de la imagen o del archivo PDF. Debe ser un enlace HTTP o HTTPS de acceso público.

https://***.jpg

CredentialOcrPictureFile

InputStream

Flujo de archivo de la credencial. Para obtener más información, consulte Advanced feature: Configure file upload.

FileInputType

String

No

Tipo de archivo de entrada.

  • IMAGE: archivo de imagen. (Valor predeterminado)

  • PDF: archivo PDF. El sistema extrae automáticamente la primera página del PDF para el reconocimiento.

IMAGE

DocType

String

Sí

Tipo de credencial:

  • 02: certificado de registro de vehículo

02

OcrArea

String

Sí

Tipo de extracción:

  • 0201: documento de registro de vehículo de Tailandia

  • 0202: documento de registro de vehículo de Hong Kong

  • 0203: documento de registro de vehículo de Macao

0201

FraudCheck

String

Sí

Especifica si se habilita la detección de alteraciones.

  • true: habilite la detección de alteraciones.

  • false: deshabilita la detección de alteraciones.

true

CheckRuleConfig

String

No

Configuración de las reglas de validación de campos, especificada como una cadena JSON.

{
  "address_rule": "Includes Address 'Hangzhou'",
  "name_rule": "Includes Name 'Zhang'",
  "date_of_issue_rule": "Within '2026-05-20'"
}

OcrValueStandard

String

No

Especifica si se estandarizan los resultados de OCR.

  • 0: no. (Valor predeterminado)

  • 1: sí.

0

OcrTranslation

String

No

Especifica si se habilita la traducción.

  • 0: no. (Valor predeterminado)

  • 1: sí.

0

Parámetros de respuesta

Parámetro

Tipo

Descripción

Ejemplo

Código de estado HTTP

Integer

Código de estado HTTP.

200

Cuerpo HTTP

RequestId

String

Identificador único de la solicitud.

130A2C10-B9EE-4D84-88E3-5384FF039****

Result.TransactionId

String

Identificador único de todo el proceso.

hksb7ba1b28130d24e015d694361b****

Code

String

Código de resultado. Para obtener más detalles, consulte Server-side HTTP status codes.

Importante
  • Este parámetro indica si la llamada a la API fue exitosa.

  • Para obtener el resultado de verificación del negocio, compruebe el resultado de la tarea asíncrona.

Success

Message

String

Mensaje que proporciona detalles sobre la respuesta.

success