Simswap - API ID Mobile
Utilisez cet 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 :
Prérequis - Simswap nécessite un
token obtenu au préalable via l'endpoint ID Mobile Access Token. Appelez d'abord ACCESS_TOKEN et transmettez la valeur access_token retournée comme paramètre token ci-dessous.simswap
Requête
GET et POST sont toutes deux prises en charge.
{SERVER_ADDRESS} et {LICENCE_CODE} sont fournis par DQE à la création du compte. Contactez votre chargé de compte DQE pour obtenir ces identifiants.
GEThttps://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME}
Exemples de code
Vérifier un échange de carte SIM sur un numéro de téléphone
curl "https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME}"
fetch("https://{SERVER_ADDRESS}/IDMOBILE/?" + new URLSearchParams({
number: "{NUM}",
token: "{TOKEN}",
licence: "{LICENCE_CODE}",
scope: "simswap",
period: "{PERIOD}",
name: "{NAME}"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/IDMOBILE/",
params={
"number": "{NUM}",
"token": "{TOKEN}",
"licence": "{LICENCE_CODE}",
"scope": "simswap",
"period": "{PERIOD}",
"name": "{NAME}",
},
)
print(response.json())
<?php
$params = http_build_query([
'number' => '{NUM}',
'token' => '{TOKEN}',
'licence' => '{LICENCE_CODE}',
'scope' => 'simswap',
'period' => '{PERIOD}',
'name' => '{NAME}',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/IDMOBILE/?{$params}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
axios.get('https://{SERVER_ADDRESS}/IDMOBILE/', {
params: {
number: '{NUM}',
token: '{TOKEN}',
licence: '{LICENCE_CODE}',
scope: 'simswap',
period: '{PERIOD}',
name: '{NAME}'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/IDMOBILE/"
+ "?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.GET()
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var url = "https://{SERVER_ADDRESS}/IDMOBILE/" +
"?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME}";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://{SERVER_ADDRESS}/IDMOBILE/" +
"?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME}"
resp, err := http.Get(url)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
POSThttps://{SERVER_ADDRESS}/IDMOBILE/
Ajoutez les paramètres suivants dans le corps de la requête au format Content-Type: application/x-www-form-urlencoded.
Exemples de code
Vérifier un échange de carte SIM sur un numéro de téléphone
curl -X POST "https://{SERVER_ADDRESS}/IDMOBILE/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "licence={LICENCE_CODE}" \
-d "number={NUM}" \
-d "token={TOKEN}" \
-d "scope=simswap" \
-d "period={PERIOD}" \
-d "name={NAME}"
fetch("https://{SERVER_ADDRESS}/IDMOBILE/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
licence: "{LICENCE_CODE}",
number: "{NUM}",
token: "{TOKEN}",
scope: "simswap",
period: "{PERIOD}",
name: "{NAME}"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/IDMOBILE/",
data={
"licence": "{LICENCE_CODE}",
"number": "{NUM}",
"token": "{TOKEN}",
"scope": "simswap",
"period": "{PERIOD}",
"name": "{NAME}",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/IDMOBILE/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'licence' => '{LICENCE_CODE}',
'number' => '{NUM}',
'token' => '{TOKEN}',
'scope' => 'simswap',
'period' => '{PERIOD}',
'name' => '{NAME}',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
const qs = require('querystring');
axios.post('https://{SERVER_ADDRESS}/IDMOBILE/', qs.stringify({
licence: '{LICENCE_CODE}',
number: '{NUM}',
token: '{TOKEN}',
scope: 'simswap',
period: '{PERIOD}',
name: '{NAME}'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "licence={LICENCE_CODE}&number={NUM}&token={TOKEN}&scope=simswap&period={PERIOD}&name={NAME}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/IDMOBILE/"))
.header("Content-Type", "application/x-www-form-urlencoded")
.POST(HttpRequest.BodyPublishers.ofString(form))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var form = new Dictionary<string, string> {
["licence"] = "{LICENCE_CODE}",
["number"] = "{NUM}",
["token"] = "{TOKEN}",
["scope"] = "simswap",
["period"] = "{PERIOD}",
["name"] = "{NAME}"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/IDMOBILE/",
new FormUrlEncodedContent(form));
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
form := url.Values{}
form.Set("licence", "{LICENCE_CODE}")
form.Set("number", "{NUM}")
form.Set("token", "{TOKEN}")
form.Set("scope", "simswap")
form.Set("period", "{PERIOD}")
form.Set("name", "{NAME}")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/IDMOBILE/", form)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Paramètres
| Paramètre | Description | Obl / Opt |
|---|---|---|
| SERVER_ADDRESS | Adresse du serveur DQE qui traitera les données. | Obligatoire |
| licence | Numéro attribué en tant que code de licence. | Obligatoire |
| number | Numéro de téléphone. | Obligatoire |
| token | Jeton récupéré lors de l'authentification. | Obligatoire |
| scope | Valeur statique. Doit être simswap pour ce scope.
Valeur fixe : simswap
|
Obligatoire |
| period | Période passée sur laquelle porte la vérification de l'échange de SIM. Valeur en heures. | Obligatoire |
| name | Nom du client dans la base de données DQE. | Obligatoire |
Combinaison de scopes —
simswap peut être combiné avec matching_notp (score de fraude) dans une même requête, par exemple scope=simswap,matching_notp, et avec info (renseignements sur le numéro de téléphone) dans n'importe quelle combinaison, par exemple scope=simswap,info. Voir les champs info ci-dessous. Contactez votre chargé de compte DQE pour connaître la forme complète de la réponse combinée `simswap`+`matching_notp`.Champs additionnels info — renvoyés en plus des champs propres à cet endpoint lorsque info est inclus dans scope :
| Champ | Description | Exemple |
|---|---|---|
| telorigine | Numéro de téléphone de la requête. | 0600000000 |
| tel | Numéro de téléphone, formaté. | +33600000000 |
| geolocation | Situation géographique du numéro de téléphone. | FRANCE |
| operator | Opérateur actuel du numéro de téléphone, si abonné. | ORANGE |
| oldoperator | Ancien opérateur du numéro de téléphone. | SFR |
| ported | Indique si le numéro de téléphone a été porté, si abonné. | Y |
| type | Type du numéro de téléphone. | MOBILE |
| iderror | Code d'erreur de la vérification (0 ou 1). |
1 |
Réponse
L'API renvoie 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 de réponse
Exemple de réponse simswap
{
"status": "success",
"operator": "Orange",
"swapped": "false"
}
Erreurs
Ces codes d'erreur sont partagés entre les scopes ID Mobile — l'API indexe les erreurs par code, pas par endpoint. Les codes 09 et 12 à 17 dépendent de l'éligibilité du numéro de téléphone et de la configuration de l'opérateur interrogé, plutôt que d'un seul paramètre erroné ; l'exemple de requête affiché est un appel simswap syntaxiquement valide, et l'erreur est renvoyée selon l'état du compte, de l'opérateur ou du numéro.
| ID | Type d'erreur | Exemple de requête | Réponse |
|---|---|---|---|
| 01 | invalid request | https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&period={PERIOD}&name={NAME} |
{"status": "error", "error_type": "invalid request", "error_id": "01"} |
| 02 | invalid licence key | https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={INCORRECT_LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME} |
{"status": "error", "error_type": "invalid licence key", "error_id": "02"} |
| 04 | invalid scope | https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=unknown&period={PERIOD}&name={NAME} |
{"status": "error", "error_type": "invalid scope", "error_id": "04"} |
| 05 | missing or empty parameter (user_infos) for this scope | Non déclenchable avec les paramètres propres à Simswap (code d'erreur commun à la plateforme) | {"status": "error", "error_type": "missing or empty parameter (user_infos) for this scope", "error_id": "05"} |
| 06 | bad parameter format (user_infos) is not a valid JSON | Non déclenchable avec les paramètres propres à Simswap (code d'erreur commun à la plateforme) | {"status": "error", "error_type": "bad parameter format (user_infos) is not a valid JSON", "error_id": "06"} |
| 07 | missing mandatory key in user informations (phone) | Non déclenchable avec les paramètres propres à Simswap (code d'erreur commun à la plateforme) | {"status": "error", "error_type": "missing mandatory key in user informations (phone)", "error_id": "07"} |
| 09 | ineligible phone number | https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME} |
{"status": "error", "error_type": "ineligible phone number", "error_id": "09"} |
| 10 | invalid phone number | https://{SERVER_ADDRESS}/IDMOBILE/?number={INVALID_NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME} |
{"status": "error", "error_type": "invalid phone number", "error_id": "10"} |
| 11 | phone number is empty | https://{SERVER_ADDRESS}/IDMOBILE/?number=&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME} |
{"status": "error", "error_type": "phone number is empty", "error_id": "11"} |
| 12 | phone check failed | https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME} |
{"status": "error", "error_type": "phone check failed", "error_id": "12"} |
| 13 | operator [Operator Name] not found | https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME} |
{"status": "error", "error_type": "operator [Operator Name] not found", "error_id": "13"} |
| 14 | operator [Operator Name] not authorized for this licence | https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME} |
{"status": "error", "error_type": "operator [Operator Name] not authorized for this licence", "error_id": "14"} |
| 15 | operator [Operator Name] not supported yet | https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME} |
{"status": "error", "error_type": "operator [Operator Name] not supported yet", "error_id": "15"} |
| 16 | operator [Operator Name] unreachable | https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME} |
{"status": "error", "error_type": "operator [Operator Name] unreachable", "error_id": "16"} |
| 17 | scope not supported by this operator [Operator Name] yet | https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME} |
{"status": "error", "error_type": "scope not supported by this operator [Operator Name] yet", "error_id": "17"} |
| 30 | invalid or expired token | https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={EXPIRED_TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME} |
{"status": "error", "error_type": "invalid or expired token", "error_id": "30"} |
Tester l'API
Cliquez sur le bouton ci-dessous pour tester cet endpoint en direct dans votre navigateur.