Todos los productos
Search
Centro de documentos

ID Verification:IDN_META

Última actualización: Sep 18, 2026

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:

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

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

Depuración e integración en línea

Nota

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 de 640*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.

    Nota

    Convertir 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 yyyy-mm-dd

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.

"consent": {
"consentedAt": "1614089870",
"consentGiven": true
}

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

e-Mail

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: aprobado.

  • N: con errores.

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

  • govId, fullName, dob: 1.0 indica una coincidencia exacta con el origen de datos oficial. Un valor inferior a 1.0 indica que no hay coincidencia.

  • selfiePhoto: un valor superior a 0.8 indica coincidencia con el origen de datos oficial. Un valor igual o inferior a 0.8 indica que no hay coincidencia.

  • liveness: un valor superior a 0.95 indica un riesgo en la detección de vitalidad.

  • imgManipulationScore: un valor superior a 0.95 indica riesgo de manipulación de la imagen.

{
  "govId": 1.0,
  "fullName": 1.0,
  "dob": 0.9,
  "selfiePhoto": 0.8777,
  "liveness": 0.1152,
  "imgManipulationScore": 0.2253
}

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.