Obtiene el resultado de una verificación de identidad por NFC. Llame a esta operación desde su servidor después de recibir una notificación de callback.
API reference
Nombre de la operación: CheckResult
Método de solicitud: HTTPS POST
-
Description: Cuando el lado del servidor recibe un callback que indica que la autenticación finalizó, llame a esta API para obtener el estado y la información de autenticación correspondientes. Este callback se envía cuando el código de resultado del cliente es 1001 o 1002. Para más información, consulte Native SDK client result codes and sub-codes.
ImportanteEl servicio ID Verification almacena los resultados de verificación durante 30 días de forma predeterminada. Obténgalos dentro de este periodo, ya que se eliminan automáticamente después.
-
Límite de QPS: cada API tiene su propio límite de QPS. Para más información, consulte QPS limits of ID Verification server-side APIs.
-
Endpoints 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 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 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
Asia Pacific SE 5 (Jakarta)
Endpoint público:
cloudauth-intl.ap-southeast-5.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com
China (Hong Kong)
Endpoint público:
cloudauth-intl.cn-hongkong.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.cn-hongkong.aliyuncs.com
Asia Pacific SE 3 (Kuala Lumpur)
Endpoint público:
cloudauth-intl.ap-southeast-3.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-3.aliyuncs.com
Depuración e integración en línea
Antes de depurar e integrar, lea el documento Use OpenAPI para aprender cómo llamar a las API en la plataforma OpenAPI y obtener el SDK.
Puede ejecutar directamente esta operación en OpenAPI Explorer para probarla y generar ejemplos de código del SDK para esta operación.Ejemplos de código del SDK.
Parámetros de solicitud
Nombre | Tipo | Obligatorio | Descripción | Valor de ejemplo |
MerchantBizId | String | Sí | Identificador de negocio único para la resolución de problemas. Admite hasta 32 caracteres alfanuméricos. Asegúrese de que sea único en todo su negocio. Nota Alibaba Cloud no valida la unicidad. Asegúrese de que sea único para garantizar la trazabilidad. | e0c34a77f5ac40a5aa5e6ed20c35**** |
TransactionId | String | Sí | El identificador de autenticación único que devuelve una llamada exitosa a la API init. Para evitar alteraciones, obtenga siempre este valor desde el almacenamiento de su servidor y no confíe en el valor enviado desde el cliente. | hksb7ba1b28130d24e015d6**** |
IsReturnImage | String | No | Indica si se devuelve la imagen de verificación:
| Y |
Parámetros 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-5384FF03**** |
Code | String | Código de retorno. Para más información, consulte Server-side HTTP status codes. | Success | |
Message | String | Descripción detallada del código de retorno. | success | |
Result.Passed | String | Resultado final de la verificación:
| Y | |
Result.SubCode | String | Descripción del resultado de verificación. SubCode error codes for ResultObject. | 200 | |
Result.ExtIdInfo | String | Información del documento leída por NFC. | | |
Códigos de error SubCode para ResultObject
El SubCode se devuelve según las distintas soluciones de producto o métodos de integración. Para más detalles, consulte la siguiente tabla.
Solución aplicable | Código de error | ¿Se factura el registro de autenticación? | Descripción y posibles causas |
General | 200 | Sí | La autenticación se aprobó. |
| 211 | Sí | La calidad o la resolución de la imagen del certificado no cumple los requisitos, o bien la imagen está incompleta. Asegúrese de que la fotografía del lado con retrato del certificado sea nítida, tenga una exposición normal, esté completa sin obstrucciones y no presente desviaciones de ángulo significativas. |
| 212 | Sí | La detección antifalsificación del certificado indica riesgo. Es posible que existan operaciones de alto riesgo, como volver a fotografiar, alterar o fotocopiar el documento. |
| 213 | Sí | No se detectó el tipo de certificado especificado (modo de reconocimiento) o no fue posible identificarlo (modo de clasificación). Se recomienda cargar una imagen del certificado nítida, completa y con un ángulo normal. |
ExtIdInfo
|
Nombre |
Tipo |
Descripción |
Ejemplo |
|
nfcIdImage |
String |
Fotografía del rostro codificada en Base64, leída del documento mediante NFC. Se devuelve únicamente cuando isReturnImage es Y y la verificación se aprueba. |
base64 |
|
nfcIdInfo |
String |
Campos del documento leídos mediante NFC. Compatible solo con pasaportes globales. Los detalles de los campos se muestran en la siguiente tabla. |
Pasaporte electrónico
Este tipo de documento lee la zona de lectura mecánica (MRZ) de los pasaportes electrónicos compatibles con la ICAO. Extraer un conjunto estándar de campos garantiza la compatibilidad entre pasaportes de distintos países, los cuales suelen tener formatos diferentes.
|
Parameter |
Type |
Description |
|
surname |
String |
Apellido en caracteres latinos obtenido de la MRZ. |
|
givenname |
String |
Nombre de pila en caracteres latinos obtenido de la MRZ. |
|
sex |
String |
Sexo, devuelto como |
|
birthDate |
String |
Fecha de nacimiento, en formato |
|
passportNo |
String |
Número de pasaporte |
|
nationality |
String |
Nacionalidad, representada por un código de país de 3 letras. |
|
expiryDate |
String |
Fecha de vencimiento, en formato |
|
countryCode |
String |
Código de país de la autoridad emisora. (código de país de 3 letras) |