Este tema describe la API Credential Detection, que analiza imágenes de credenciales para detectar riesgos como falsificación, alteración, capturas de pantalla y fotografías de pantallas.
Información de la API
Nombre de la API: CredentialVerifyIntl
Descripción: detecta riesgos en las imágenes de credenciales, como falsificación, alteración, capturas de pantalla y fotografías de pantallas.
Método de solicitud: POST
Protocolo: 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.
-
Dirección del servicio:
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 el servidor de su aplicación está desplegado en la misma región, use 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 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
Credential Detection es un servicio predictivo basado en inteligencia artificial. Alcanza una precisión del 90 % en nuestro conjunto de datos de prueba interno. La precisión real puede variar según los escenarios específicos y las muestras de imágenes.
El servicio detecta con mayor eficacia las manipulaciones en imágenes capturadas por una cámara que en imágenes generadas o editadas digitalmente.
El resultado de la detección no es el único criterio para determinar la autenticidad de una credencial. Úselo como herramienta complementaria para mejorar la eficiencia de la revisión manual.
Credential Detection se usa ampliamente en la revisión de documentos electrónicos para escenarios como la adquisición de pagos y el registro de comerciantes de comercio electrónico. Este servicio mejora de manera efectiva la eficiencia de la revisión manual. Si necesita otros casos de uso, comuníquese con su administrador de cuenta.
Depuración e integración en línea
Antes de depurar e integrar, lea el documento Use OpenAPI para aprender a invocar las API en la plataforma OpenAPI y obtener el SDK.
Use OpenAPI Explorer para depurar esta API en línea y generar un ejemplo de código del SDK.
Parámetros de solicitud
La imagen especificada mediante el parámetro ImageUrl o ImageFileObject debe cumplir los siguientes requisitos:
Formato de imagen: PNG, JPG, JPEG, BMP y WebP.
-
Dimensiones de la imagen: el ancho y el alto deben ser mayores que 15 píxeles y menores que 8192 píxeles. La relación de aspecto debe ser menor que 50.
NotaPara obtener resultados de detección óptimos, se recomienda que tanto el ancho como el alto de la imagen sean mayores que 500 píxeles.
-
Tamaño de la imagen: el archivo de imagen no debe superar los 10 MB si usa
ImageUrlni los 3 MB si usaImageFileObject.NotaLas imágenes grandes aumentan el tiempo de respuesta de la API. Se recomienda usar imágenes menores que 3 MB.
Parámetro | Tipo | Obligatorio | Descripción | Ejemplo |
CredType | String | Sí | Tipo de credencial. Valores válidos:
| 03 |
CredName | String | Sí | Nombre de la credencial, especificado mediante un código numérico. Valores válidos:
Nota Si necesita compatibilidad con tipos de credenciales adicionales, comuníquese con su administrador de cuenta. | 0301 |
ProductCode | String | Sí | Modo de invocación. Valor válido:
| ANTI_FAKE_CHECK |
ImageUrl | String | Sí Importante Especifique el parámetro ImageUrl o ImageFileObject. | URL de la imagen. | https://example.com/test.jpg |
ImageFileObject | InputStream | Flujo del archivo de imagen. Para cargar un archivo con este parámetro, debe invocar la operación Advance API y pasar un objeto InputStream válido. Para obtener más información, consulte Special scenario: Configure the Advance API for file uploads. | Objeto InputStream que representa la imagen. |
Parámetros de respuesta
Parámetro | Tipo | Descripción | Ejemplo | |
RequestId | String | ID de la solicitud. | 130A2C10-B9EE-4D84-88E3-5384**** | |
Code | String | Código de respuesta. Para obtener más información, consulte Server-side HTTP status codes. Importante
| Success | |
Message | String | Descripción detallada del código de respuesta. | success | |
ResultObject | Result | String |
| 1 |
RiskTag | String | Etiqueta de riesgo. Varias etiquetas se separan con comas (,). Valores válidos:
| PS | |
RiskScore | Map<String,String> | Puntuación de riesgo predicha para cada etiqueta de riesgo. Los valores van de 0 a 1. Una puntuación más alta indica una mayor probabilidad del riesgo correspondiente. | | |
MaterialInfo | String | Información adicional. Este parámetro está reservado. | ||