Utilisez ce endpoint pour comparer les données soumises par l'utilisateur aux données de l'opérateur, sans nécessiter le consentement de l'utilisateur (OTP). Retourne un score de similarité pour chaque champ.
Documentation ID Mobile associée :
Requête 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}Remplacez les valeurs entre accolades par vos propres informations :
| Paramètre | Description | Obligatoire/Optionnel |
|---|---|---|
| SERVER_ADDRESS | Adresse du serveur DQE qui traitera les données. | Obligatoire |
| licence | Numéro qui vous a été attribué comme code de licence. | Obligatoire |
| number | Numéro de téléphone. | Obligatoire |
| token | Token récupéré via l'authentification. | Obligatoire |
| mode |
2 : authentification par code. |
Obligatoire |
| name | Nom du partenaire dans la base de données DQE Software, généralement le nom de votre entreprise. | Obligatoire |
| code_name | Champ optionnel contenant un code associé à name. |
Optionnel |
| user_infos | Objet JSON contenant les informations du client à comparer. Voir le tableau des clés user_infos ci-dessous. Obligatoire si le scope est matching_notp. |
Optionnel |
| scope | Valeur statique. Doit être matching_notp pour ce scope. |
Obligatoire |
| redirect_uri | URL de redirection. DQE ajoute le token de session et le statut à la redirection. | Optionnel |
| country | À utiliser uniquement pour le Matching without OTP international. Valeur attendue : code pays ISO à 2 lettres. | Optionnel |
Clés user_infos — chaque clé doit être présente, même si aucune valeur n'est fournie :
| Clé | Description |
|---|---|
street_address |
Type et nom de la rue. |
postal_code |
Code postal. |
locality |
Ville. |
country |
Nom complet du pays. |
birthdate |
Date de naissance au format YYYY-MM-DD. |
email |
Adresse e-mail. |
lastname |
Nom de famille. |
maiden_name |
Nom de jeune fille. |
gender |
Genre : M ou F. |
firstname |
Prénom. |
phone |
Numéro de téléphone. |
number |
Numéro de rue. |
Requête POST
https://{SERVER_ADDRESS}/IDMOBILE/Ajoutez les paramètres suivants dans le corps de la requête en utilisant x-www-form-urlencoded :
| Paramètre | Description | Obligatoire/Optionnel |
|---|---|---|
| licence | Numéro qui vous a été attribué comme code de licence. | Obligatoire |
| number | Numéro de téléphone. | Obligatoire |
| token | Token récupéré via l'authentification. | Obligatoire |
| mode |
2 : authentification par code. |
Obligatoire |
| name | Nom du partenaire dans la base de données DQE Software, généralement le nom de votre entreprise. | Obligatoire |
| code_name | Champ optionnel contenant un code associé à name. |
Optionnel |
| user_infos | Objet JSON contenant les informations du client à comparer. Obligatoire si le scope est matching_notp. |
Optionnel |
| scope | Valeur statique. Doit être matching_notp pour ce scope. |
Obligatoire |
| redirect_uri | URL de redirection. DQE ajoute le token de session et le statut à la redirection. | Optionnel |
| country | À utiliser uniquement pour le Matching without OTP international. Valeur attendue : code pays ISO à 2 lettres. | Optionnel |
Réponse
Succès — identification directe
L'API retourne un objet JSON avec un score de similarité pour chaque champ :
| Clé | Description | Type |
|---|---|---|
| family_name | Score de similarité pour le nom de famille. | NUMBER |
| gender | Score de similarité pour la civilité. | NUMBER |
| birthdate | Score de similarité pour la date de naissance. | NUMBER |
| given_name | Score de similarité pour le prénom. | NUMBER |
| address | Objet contenant les scores de similarité de l'adresse. Clés : country, postal_code, street_address, locality. |
JSON OBJECT |
| Score de similarité pour l'adresse e-mail. | NUMBER |
Exemple :
{
"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
}Erreur
L'API retourne un objet JSON contenant les clés suivantes :
| Clé | Description | Type |
|---|---|---|
| status | error |
STRING |
| error_type | Libellé de l'erreur. Les détails sont fournis dans le tableau ci-dessous. | STRING |
| error_id | Code d'erreur. Les détails sont fournis dans le tableau ci-dessous. | STRING(2) |
Détails des codes d'erreur :
| ID d'erreur | Type d'erreur | Description |
|---|---|---|
| 01 | invalid request | La requête n'est pas valide. |
| 02 | invalid licence key | La licence n'est pas valide. |
| 04 | invalid scope | Scope invalide. |
| 05 | missing or empty parameter (user_infos) for this scope | Un paramètre est manquant pour le scope demandé. |
| 06 | bad parameter format (user_infos) is not a valid JSON | Le paramètre user_infos n'est pas un JSON valide. |
| 07 | missing mandatory key in user informations (phone) | La clé phone est obligatoire dans le paramètre user_infos pour cet opérateur. |
| 09 | ineligible phone number | Le numéro de téléphone n'est pas éligible à la solution. |
| 10 | invalid phone number | Le numéro de téléphone n'existe pas. |
| 11 | phone number is empty | Le numéro de téléphone est vide. |
| 12 | phone check failed | La vérification de l'opérateur a échoué. |
| 13 | operator [Operator Name] not found | L'opérateur n'a pas pu être trouvé. |
| 14 | operator [Operator Name] not authorized for this licence | Votre licence n'est pas autorisée pour cet opérateur. |
| 15 | operator [Operator Name] not supported yet | La solution n'est pas encore disponible pour cet opérateur. |
| 16 | operator [Operator Name] unreachable | L'opérateur n'a pas pu être contacté. |
| 17 | scope not supported by this operator [Operator Name] yet | Ce scope n'est pas pris en charge par l'opérateur. |
| 30 | invalid or expired token | Le token a expiré. |
Exemple :
{
"status": "error",
"error_type": "invalid phone number",
"error_id": "10"
}