Utilisez ce endpoint pour vérifier si la carte SIM associée à un numéro de téléphone a été échangée au cours d'une période donnée.
Documentation ID Mobile associée :
Requête GET
https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME}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 |
| scope | Valeur statique. Doit être simswap pour ce scope. |
Obligatoire |
| period | Période passée pendant laquelle la vérification du changement de carte SIM est effectuée. Valeur en heures. | Obligatoire |
| name | Nom du client dans la base de données DQE. | Obligatoire |
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 |
| scope | Valeur statique. Doit être simswap pour ce scope. |
Obligatoire |
| period | Période passée pendant laquelle la vérification du changement de carte SIM est effectuée. Valeur en heures. | Obligatoire |
| name | Nom du client dans la base de données DQE. | Obligatoire |
Réponse
Succès
L'API retourne un objet JSON contenant les clés suivantes :
| Clé | Description | Type |
|---|---|---|
| status | Libellé du statut de la requête. | STRING |
| operator | Opérateur du numéro de téléphone. | STRING |
| swapped | Indique si la carte SIM a été échangée : true ou false. |
STRING |
Exemple :
{
"status": "success",
"operator": "Orange",
"swapped": "false"
}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 obligatoire 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"
}