IDN META verifica la identidad de los usuarios indonesios. Para ello, compara el número de identificación, el nombre, la imagen facial y la fecha de nacimiento con una base de datos oficial.
Descripción de la API
Nombre de la API: IdnAuthorityVerifyIntl
Método de solicitud: HTTPS POST
Verifica la información de identidad de los usuarios indonesios.
-
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 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 su servidor de aplicaciones está desplegado en la misma región, utilice el endpoint interno para acceder al servicio ID Verification. De esta forma obtendrá mayor seguridad y estabilidad.
Optimización del acceso desde el extranjero: los entornos de red internacionales suelen 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 5 (Jakarta)
Endpoint público:
cloudauth-intl.ap-southeast-5.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com
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.
Ejecute esta API en OpenAPI Explorer para depurarla y generar un SDK Code Examples.
Requisitos de formato de la imagen facial
Formato de imagen: JPG, JPEG, PNG.
Tamaño de imagen: se recomiendan entre 50 y 100 KB, con un máximo de 1 MB.
-
Resolución de imagen: máxima de
1920*1080(alto × ancho) y mínima de640*480(alto × ancho). Se recomienda escalar el lado más corto a 720 píxeles con una relación de compresión superior a 0.9. El alto debe ser mayor que el ancho. Si la fotografía cargada tiene un ancho mayor que el alto, los resultados de detección podrían verse afectados.NotaConvertir imágenes a Base64 suele aumentar el tamaño de los datos. Si pasa parámetros en formato Base64, asegúrese de que la imagen original no supere los 0.6 MB para mantenerse dentro del límite de transferencia de 1 MB.
-
Recomendaciones sobre la calidad de la imagen:
El rostro debe estar completo, nítido y sin obstrucciones, mirando directamente a la cámara. Utilice la cámara frontal para obtener mejores resultados.
El rostro debe ocupar más del 60 % del área de la imagen. Un rostro más pequeño puede reducir la precisión de la detección.
Si hay varios rostros, el algoritmo selecciona el más grande de forma predeterminada. Evite las imágenes con varios rostros.
Parámetros de solicitud
|
Nombre |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
|
ProductCode |
String |
Sí |
Código del producto. Establezca este valor en IDN_META. |
IDN_META |
|
SceneCode |
String |
No |
Identificador de escenario personalizado para consultar los registros relacionados en la consola. Consta de letras, dígitos y guiones bajos, con un máximo de 10 caracteres. |
1234567890 |
|
MerchantBizId |
String |
Sí |
Identificador único de negocio personalizado para solucionar problemas. Admite letras y dígitos, con un máximo de 32 caracteres. Debe ser único. |
e0c34a77f5ac40a5aa5e6ed20c35**** |
|
MerchantUserId |
String |
No |
Identificador o ID de usuario personalizado, como un número de celular o una dirección de correo electrónico. Se recomienda aplicar técnicas de anonimización a este valor previamente, por ejemplo, mediante un hash. |
123456789 |
|
idNumber |
String |
Sí |
El NIK (National Identification Number) que aparece en la tarjeta de identificación (KTP). |
|
|
birthDate |
String |
Sí |
Fecha de nacimiento del usuario registrada en la tarjeta de identificación (KTP). |
Formato |
|
fullName |
String |
Sí |
Nombre del usuario registrado en la tarjeta de identificación (KTP). |
|
|
timestamp |
String |
Sí |
Marca de tiempo en la que el usuario dio su consentimiento para compartir datos con la base de datos oficial. Pase una marca de tiempo real. |
|
|
SourceFacePicture |
String |
Sí. Solo necesita elegir uno de los tres métodos de carga. |
Fotografía facial codificada en Base64 para reconocimiento y comparación. Tamaño máximo de 1 MB, en formato JPEG o JPG. Resolución recomendada: 480×640. |
base64 |
|
SourceFacePictureUrl |
String |
URL de la fotografía facial para reconocimiento y comparación. Debe ser un enlace HTTP o HTTPS accesible públicamente. |
https://*** |
|
|
SourceFacePictureFiles |
InputSteam |
Flujo de archivo de la fotografía facial para comparación. |
Objeto InputSteam de imagen |
|
|
Mobile |
String |
Sí |
Número de celular indonesio que comienza con +62, seguido de 9 a 11 dígitos. |
+6281293671234 |
|
|
String |
Sí |
Dirección de correo electrónico del usuario. Debe ser válida. |
example@gmail.com |
Datos de respuesta
|
Nombre |
Tipo |
Descripción |
Ejemplo |
|
|
HTTP Status Code |
Integer |
Código de estado HTTP. |
200 |
|
|
HTTP Body |
RequestId |
String |
ID de la solicitud. |
130A2C10-B9EE-4D84-88E3-5384FF0**** |
|
Result.TransactionId |
String |
ID de transacción único del proceso de autenticación. |
hksb7ba1b28130d24e015d694361**** |
|
|
Code |
String |
Código de retorno. Para más detalles, consulte Server-side HTTP status codes. |
Success |
|
|
Message |
String |
Esta sección proporciona descripciones detalladas de los códigos de retorno. |
Success |
|
|
Result.Passed |
String |
Resultado de la autenticación. Valores válidos:
|
Y |
|
|
Result.SubCode |
String |
Descripción del resultado de autenticación. Para obtener más información, consulte ResultObject.SubCode error codes. |
200 |
|
|
Result.ExtFaceInfo |
Object |
Resultado de la verificación del origen de datos (el siguiente ejemplo utiliza el origen de datos indonesio).
|
|
|
Códigos de error de ResultObject.SubCode
|
Código de error |
Billable |
Description and Troubleshooting |
|
202 |
Yes |
No se encontró el número de identificación en el origen de datos autorizado. |
|
207 |
Sí |
La fotografía no coincide con la información del origen de datos autorizado. |
|
209 |
No |
Se agotó el tiempo de espera de la conexión con el origen de datos autorizado. |
|
214 |
Sí |
La información personal (número de identificación, nombre y fecha de nacimiento) no coincide con los datos del origen autorizado. |
|
215 |
Sí |
Ni la información personal (número de identificación, nombre y fecha de nacimiento) ni la fotografía coinciden con los registros del origen de datos autorizado. |
|
216 |
Sí |
El origen de datos autorizado detectó una anomalía de vitalidad. En el caso del origen de datos indonesio, esto se activa cuando el valor de vitalidad en ExtScoureInfo supera 0.95 o cuando imgManipulationScore supera 0.95. |
|
217 |
Sí |
La calidad de la fotografía no cumple con los requisitos. |