Utilice este endpoint para comprobar si la tarjeta SIM asociada a un número de teléfono ha sido cambiada dentro de un período especificado.
Documentación relacionada de ID Mobile:
Solicitud GET
https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME}Reemplace los valores entre llaves con su propia información:
| Parámetro | Descripción | Obligatorio/Opcional |
|---|---|---|
| SERVER_ADDRESS | Dirección del servidor DQE que procesará los datos. | Obligatorio |
| licence | Número asignado como su código de licencia. | Obligatorio |
| number | Número de teléfono. | Obligatorio |
| token | Token obtenido mediante autenticación. | Obligatorio |
| scope | Valor estático. Debe ser simswap para este scope. |
Obligatorio |
| period | Período pasado durante el cual se realiza la comprobación del cambio de SIM. Valor en horas. | Obligatorio |
| name | Nombre del cliente en la base de datos de DQE. | Obligatorio |
Solicitud POST
https://{SERVER_ADDRESS}/IDMOBILE/Añada los parámetros siguientes en el cuerpo de la solicitud usando x-www-form-urlencoded:
| Parámetro | Descripción | Obligatorio/Opcional |
|---|---|---|
| licence | Número asignado como su código de licencia. | Obligatorio |
| number | Número de teléfono. | Obligatorio |
| token | Token obtenido mediante autenticación. | Obligatorio |
| scope | Valor estático. Debe ser simswap para este scope. |
Obligatorio |
| period | Período pasado durante el cual se realiza la comprobación del cambio de SIM. Valor en horas. | Obligatorio |
| name | Nombre del cliente en la base de datos de DQE. | Obligatorio |
Respuesta
Éxito
La API devuelve un objeto JSON que contiene las siguientes claves:
| Clave | Descripción | Tipo |
|---|---|---|
| status | Etiqueta de estado de la solicitud. | STRING |
| operator | Operador del número de teléfono. | STRING |
| swapped | Indica si la tarjeta SIM ha sido cambiada: true o false. |
STRING |
Ejemplo:
{
"status": "success",
"operator": "Orange",
"swapped": "false"
}Error
La API devuelve un objeto JSON que contiene 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:
| ID de error | Tipo de error | 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 obligatorio 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 apto 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 falló. |
| 13 | operator [Operator Name] not found | No se pudo 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 pudo 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"
}