Lookup

Con este punto final, puede formatear y verificar números de teléfono. Verifique la validez de un número, a qué red móvil pertenece, formatee un número en formato nacional e internacional o compruebe si un número existe y está registrado en la red móvil.

Parámetros

Todas las consultas mencionadas a continuación solo requieren el número de teléfono como parámetro:

Formato

Consulte el formato nacional e internacional de cualquier número de teléfono móvil. Además, recibirá información sobre el operador de red asociado al número (sin información de portabilidad).

curl "https://gateway.seven.io/api/lookup/format?number=4917612345678" \
  -H "X-Api-Key: SU_CLAVE_API" \
  -H "Accept: application/json"

{
    "success": true,
    "national": "0176 12345678",
    "international": "+4917612345678",
    "international_formatted": "+49 176 12345678",
    "country_name": "Germany",
    "country_code": "49",
    "country_iso": "DE",
    "carrier": "O2",
    "network_type": "mobile"
}

Capacidades RCS

A través de este punto final, puede consultar la capacidad RCS de un número de teléfono. Antes de enviar un RCS, siempre debe consultar primero las capacidades de un número y, si es necesario, almacenar en caché el resultado.

Parámetros opcionales

curl "https://gateway.seven.io/api/lookup/rcs?number=4917612345678" \
  -H "X-Api-Key: SU_CLAVE_API" \
  -H "Accept: application/json"

{
  "success": true,
  "national": "0176 12345679",
  "international": "+49176123456789",
  "international_formatted": "+49 179 123456789",
  "country_name": "Germany",
  "country_code": "49",
  "country_iso": "DE",
  "carrier": "O2",
  "network_type": "mobile",
  "rcs_capabilities": [
    "RICHCARD_STANDALONE",
    "ACTION_CREATE_CALENDAR_EVENT",
    "ACTION_DIAL",
    "ACTION_OPEN_URL",
    "ACTION_SHARE_LOCATION",
    "ACTION_VIEW_LOCATION",
    "RICHCARD_CAROUSEL"
  ]
}

Übersicht aller Fähigkeiten

HLR

Obtenga información detallada sobre un número de teléfono móvil a través de una consulta en la base de datos HLR. La consulta es posible para números de casi todos los países/redes del mundo.

curl "https://gateway.seven.io/api/lookup/hlr?number=4917612345678" \
  -H "X-Api-Key: SU_CLAVE_API" \
  -H "Accept: application/json"

{
    "status": true,
    "status_message": "success",
    "lookup_outcome": true,
    "lookup_outcome_message": "success",
    "international_format_number": "4917612345678",
    "international_formatted": "+49 176 12345678",
    "national_format_number": "0176 12345678",
    "country_code": "DE",
    "country_name": "Germany",
    "country_prefix": "49",
    "current_carrier":
    {
        "network_code": "26207",
        "name": "Telefonica Germany GmbH & Co. OHG",
        "country": "DE",
        "network_type": "mobile"
    },
    "original_carrier":
    {
        "network_code": "26207",
        "name": "Telefonica Germany GmbH & Co. OHG",
        "country": "DE",
        "network_type": "mobile"
    },
    "valid_number": "valid",
    "reachable": "unknown",
    "ported": "assumed_not_ported",
    "roaming": "not_roaming",
    "gsm_code": null,
    "gsm_message": null
}

MNP

Consulte a través de nuestra API MNP (Mobile Number Ported) el operador de red de cualquier número de teléfono internacional.

curl "https://gateway.seven.io/api/lookup/mnp?number=4917612345678" \
  -H "X-Api-Key: SU_CLAVE_API" \
  -H "Accept: application/json"

{
    "success": true,
    "code": 100,
    "price": 0.005,
    "mnp":
    {
        "country": "DE",
        "number": "+4917612345678",
        "national_format": "0176 12345678",
        "international_formatted": "+49 176 12345678",
        "network": "Telekom Deutschland GmbH",
        "mccmnc": "26201",
        "isPorted": true,
        "network_type": "mobile"
    }
}

CNAM

Con la consulta CNAM, puede consultar el nombre de identificación de llamada para cualquier número de teléfono en todo el mundo. Tenga en cuenta que no hay una entrada para cada número de teléfono. Dado que los datos se recopilan de diversas fuentes, a veces se registran ubicaciones geográficas, nombres de empresas/nombres o el operador de red.

curl "https://gateway.seven.io/api/lookup/cnam?number=4917612345678" \
  -H "X-Api-Key: SU_CLAVE_API" \
  -H "Accept: application/json"

{
	"success": "true",
	"code": "100",
	"number": "4917612345678",
	"name": "GERMANY"
}

Cobertura

CNAM es originalmente una función de red norteamericana. Para los números dentro del NANP (prefijo de país +1), los operadores mantienen ellos mismos el nombre de identificación de llamada, por lo que el name devuelto suele ser el titular real de la línea: un nombre de persona o de empresa.

Fuera del NANP no existe una base de datos de nombres equivalente a nivel de red. Los datos se recopilan de diversas fuentes, por lo que en números internacionales la respuesta contiene a menudo una designación geográfica (como en el ejemplo anterior: GERMANY), un nombre de empresa disponible públicamente o el operador de red. Una consulta internacional casi siempre devuelve un valor, pero ese valor no es necesariamente el nombre del titular.

Comportamiento cuando no hay entrada

Si la fuente de datos no devuelve ningún resultado o no está disponible, la entrada de la respuesta solo contiene el código de error, sin success, number ni name:

{
	"code": "600"
}

Compruebe siempre success en lugar de confiar en que el campo name esté presente.

Facturación y consultas por lotes

Los números enviados en una misma solicitud se consultan de forma secuencial y cada consulta individual tiene un tiempo de espera de cinco segundos. Mantenga los lotes lo suficientemente pequeños para su propio tiempo de espera HTTP y reparta los grandes volúmenes en solicitudes paralelas en lugar de una lista larga. Los números duplicados dentro de una solicitud se consultan y se facturan una sola vez.

Dado que los nombres de identificación de llamada cambian rara vez, recomendamos almacenar los resultados en caché por su parte en lugar de consultar el mismo número repetidamente.