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:

Name
number
Type
string
Description
El número a consultar. Varios números deben estar separados por comas. El formato es casi arbitrario: nuestra API formatea el número automáticamente de manera correcta.

GET/api/lookup/format

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).

Anfrage

GET

/api/lookup/format

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

Antwort

{
    "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"
}

GET/api/lookup/rcs

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.

Los agentes que aún no están activados solo pueden consultar las capacidades de los números de prueba registrados.

Parámetros opcionales

Name
from
Type
string
Description
Para verificar las capacidades de RCS de un número de teléfono, siempre se necesita la identificación del agente correspondiente. Por defecto, nuestra API utiliza la primera identificación de remitente RCS en su cuenta. Con este parámetro, puede utilizar otro agente.

Anfrage

GET

/api/lookup/rcs

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

Antwort

{
  "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

Feature	Descripción
`FEATURE_UNSPECIFIED`	No especificado.
`REVOCATION`	Si esta función es compatible, puede revocar un mensaje enviado antes de que se entregue.
`RICHCARD_STANDALONE`	Tarjetas enriquecidas independientes
`RICHCARD_CAROUSEL`	Carrusel de tarjetas enriquecidas
`ACTION_CREATE_CALENDAR_EVENT`	La acción sugerida para crear un evento de calendario.
`ACTION_DIAL`	Acción sugerida para marcar un número.
`ACTION_OPEN_URL`	La acción sugerida para abrir una URL.
`ACTION_SHARE_LOCATION`	Acción sugerida para compartir la ubicación.
`ACTION_VIEW_LOCATION`	Acción sugerida para ver una ubicación en una aplicación de mapas.

GET/api/lookup/hlr

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.

Puede ocurrir que la consulta de roaming resulte en "Sin roaming", aunque el número esté en roaming. Esto generalmente significa que el enrutamiento en casa ha sido activado por el operador de red. El enrutamiento en casa asegura que la red informe el número como si estuviera en casa, independientemente de dónde se encuentre.

Anfrage

GET

/api/lookup/hlr

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

Antwort

{
    "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
}

GET/api/lookup/mnp

MNP

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

Anfrage

GET

/api/lookup/mnp

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

Antwort

{
    "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"
    }
}

GET/api/lookup/cnam

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.

Anfrage

GET

/api/lookup/cnam

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

Antwort

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