Comprobaciones que se hacen antes de dar por bueno un dato: dar de alta a alguien, mandarle un código de verificación o aceptarle un pago.

Todas las comprobaciones se piden por la misma llamada. El parámetro SERVICIO dice cuál se quiere, y los parámetros que no son de ese servicio se ignoran: puede mandar siempre la misma estructura y cambiar solo SERVICIO. Los servicios que se vayan añadiendo (correo, IP…) entrarán por aquí, sin que usted tenga que integrar otra URL.

De todo lo que se puede saber de un número sin llamarlo, estos dos datos son los que de verdad cambian una decisión.

La fecha de portabilidad. Un número que cambió de operadora hace tres días, justo antes de una operación importante, es el patrón del secuestro de línea: el atacante se lleva el número de la víctima a otro operador y a partir de ahí recibe él los SMS de verificación. Si va a mandar un código a ese número, conviene verificar antes por otra vía.

El tipo de línea. Una línea por Internet (VoIP) donde debería haber un móvil suele ser un número de usar y tirar: se contratan en minutos y se abandonan igual de rápido. Y una numeración de tarificación adicional o de máquina a máquina no es el teléfono personal de nadie.

Con eso, la respuesta trae además un riesgo calculado de 0 a 100 con los motivos en texto. No es un veredicto y no decide por usted: es lo que los datos permiten decir, explicado, para que su sistema aplique su propia política.

Para los móviles españoles se usa nuestro propio registro de portabilidad, que es lo que nos permite dar el operador del que venía el número y la fecha exacta del cambio. Para los fijos españoles y cualquier número extranjero se consulta la numeración internacional. Usted no tiene que elegir: manda el número y se resuelve por donde toque.

El campo Fuente de la respuesta le dice cuál se ha usado. El historial de portabilidad no lo publican todos los países: cuando no hay dato, Portabilidad.Consta viene a 0 —que no es lo mismo que «no se ha portado», y por eso se distinguen.

Se cobra por consulta resuelta. Si no se puede resolver, la llamada devuelve -4 y no se cobra nada.

La misma consulta repetida en menos de un minuto (un doble envío, un reintento de su sistema) devuelve el resultado anterior marcado con Repetida=1 y tampoco se cobra. Pasado ese minuto se vuelve a consultar de verdad y se vuelve a cobrar: el dato puede haber cambiado, y justo la portabilidad de ayer es la que le interesa.

Igual que el resto de nuestras APIs: autenticación Basic con su usuario y su API Token, que encontrará en su panel en Sus datos → Configurar → Seguridad. Recuerde autorizar ahí también la IP pública desde la que llamará.