Utilice este endpoint para comparar los datos enviados por el usuario con los datos del operador, sin necesidad de consentimiento del usuario (OTP). Devuelve una puntuación de similitud para cada campo.
Documentación relacionada de ID Mobile:
Solicitud GET
https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&mode={MODE}&name={NAME}&code_name={CODE_NAME}&licence={LICENCE_CODE}&user_infos={INFORMATION}&scope=matching_notp&redirect_uri={URL_REDIRECT}&country={COUNTRY}Sustituya los valores entre llaves por su propia información:
| Parámetro | Descripción | Obligatorio/Opcional |
|---|---|---|
| SERVER_ADDRESS | Dirección del servidor de DQE que procesará los datos. | Obligatorio |
| licence | Número que se le asigna como código de licencia. | Obligatorio |
| number | Número de teléfono. | Obligatorio |
| token | Token obtenido mediante autenticación. | Obligatorio |
| mode |
2: autenticación por código. |
Obligatorio |
| name | Nombre del partner en la base de datos de DQE Software, normalmente el nombre de su empresa. | Obligatorio |
| code_name | Campo opcional que contiene un código asociado a name. |
Opcional |
| user_infos | Objeto JSON que contiene la información del cliente que se debe comparar. Consulte la tabla de claves de user_infos a continuación. Obligatorio si el scope es matching_notp. |
Opcional |
| scope | Valor estático. Debe ser matching_notp para este scope. |
Obligatorio |
| redirect_uri | URL de redirección. DQE añade el token de sesión y el estado a la redirección. | Opcional |
| country | Utilícelo únicamente para Matching without OTP internacional. Valor esperado: código de país ISO de 2 letras. | Opcional |
Claves de user_infos: cada clave debe estar presente, aunque no se proporcione ningún valor:
| Clave | Descripción |
|---|---|
street_address |
Tipo y nombre de la vía. |
postal_code |
Código postal. |
locality |
Ciudad. |
country |
Nombre completo del país. |
birthdate |
Fecha de nacimiento en formato YYYY-MM-DD. |
email |
Dirección de correo electrónico. |
lastname |
Apellido. |
maiden_name |
Apellido de soltera. |
gender |
Sexo: M o F. |
firstname |
Nombre. |
phone |
Número de teléfono. |
number |
Número de la vía. |
Solicitud POST
https://{SERVER_ADDRESS}/IDMOBILE/Añada los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded:
| Parámetro | Descripción | Obligatorio/Opcional |
|---|---|---|
| licence | Número que se le asigna como código de licencia. | Obligatorio |
| number | Número de teléfono. | Obligatorio |
| token | Token obtenido mediante autenticación. | Obligatorio |
| mode |
2: autenticación por código. |
Obligatorio |
| name | Nombre del partner en la base de datos de DQE Software, normalmente el nombre de su empresa. | Obligatorio |
| code_name | Campo opcional que contiene un código asociado a name. |
Opcional |
| user_infos | Objeto JSON que contiene la información del cliente que se debe comparar. Obligatorio si el scope es matching_notp. |
Opcional |
| scope | Valor estático. Debe ser matching_notp para este scope. |
Obligatorio |
| redirect_uri | URL de redirección. DQE añade el token de sesión y el estado a la redirección. | Opcional |
| country | Utilícelo únicamente para Matching without OTP internacional. Valor esperado: código de país ISO de 2 letras. | Opcional |
Respuesta
Éxito — identificación directa
La API devuelve un objeto JSON con una puntuación de similitud para cada campo:
| Clave | Descripción | Tipo |
|---|---|---|
| family_name | Puntuación de similitud del apellido. | NUMBER |
| gender | Puntuación de similitud de la civilidad. | NUMBER |
| birthdate | Puntuación de similitud de la fecha de nacimiento. | NUMBER |
| given_name | Puntuación de similitud del nombre. | NUMBER |
| address | Objeto que contiene las puntuaciones de similitud de la dirección. Claves: country, postal_code, street_address, locality. |
JSON OBJECT |
| Puntuación de similitud de la dirección de correo electrónico. | NUMBER |
Ejemplo:
{
"family_name": 1.0,
"gender": "",
"birthdate": 1.0,
"given_name": 1.0,
"address": {
"country": 1.0,
"postal_code": 0.78,
"street_address": 0.56,
"locality": 0.44
},
"email": 1.0
}Error
La API devuelve un objeto JSON con las siguientes claves:
| Clave | Descripción | Tipo |
|---|---|---|
| status | error |
STRING |
| error_type | Etiqueta de error. Los detalles se indican en la tabla siguiente. | STRING |
| error_id | Código de error. Los detalles se indican en la tabla siguiente. | STRING(2) |
Detalles de los códigos de error:
| Error ID | Error type | Descripción |
|---|---|---|
| 01 | invalid request | La solicitud no es válida. |
| 02 | invalid licence key | La licencia no es válida. |
| 04 | invalid scope | Scope no válido. |
| 05 | missing or empty parameter (user_infos) for this scope | Falta un parámetro para el scope solicitado. |
| 06 | bad parameter format (user_infos) is not a valid JSON | El parámetro user_infos no es un JSON válido. |
| 07 | missing mandatory key in user informations (phone) | La clave phone es obligatoria en el parámetro user_infos para este operador. |
| 09 | ineligible phone number | El número de teléfono no es elegible para la solución. |
| 10 | invalid phone number | El número de teléfono no existe. |
| 11 | phone number is empty | El número de teléfono está vacío. |
| 12 | phone check failed | La verificación del operador ha fallado. |
| 13 | operator [Operator Name] not found | No se ha podido encontrar el operador. |
| 14 | operator [Operator Name] not authorized for this licence | Su licencia no está autorizada para este operador. |
| 15 | operator [Operator Name] not supported yet | La solución aún no está disponible para este operador. |
| 16 | operator [Operator Name] unreachable | No se ha podido contactar con el operador. |
| 17 | scope not supported by this operator [Operator Name] yet | Este scope aún no es compatible con el operador. |
| 30 | invalid or expired token | El token ha caducado. |
Ejemplo:
{
"status": "error",
"error_type": "invalid phone number",
"error_id": "10"
}