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:
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, 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.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com
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.
La detección de falsificaciones funciona mejor con imágenes capturadas por una cámara que con imágenes sintetizadas o alteradas digitalmente.
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.
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
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. CuandoFileInputType=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.
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 |
DocType | String | Sí | Tipo de credencial:
| 02 |
OcrArea | String | Sí | Tipo de extracción:
| 0201 |
FraudCheck | String | Sí | Especifica si se habilita la detección de alteraciones.
| true |
CheckRuleConfig | String | No | Configuración de las reglas de validación de campos, especificada como una cadena JSON. | |
OcrValueStandard | String | No | Especifica si se estandarizan los resultados de OCR.
| 0 |
OcrTranslation | String | No | Especifica si se habilita la traducción.
| 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
| Success | |
Message | String | Mensaje que proporciona detalles sobre la respuesta. | success | |