MNP Lookup

Panoramica

Interroga informazioni sulla portabilità del numero mobile (MNP) per identificare l'operatore attuale e i dettagli della rete per qualsiasi numero di telefono. L'API MNP Lookup di Agile Telecom restituisce informazioni di rete in tempo reale inclusi Mobile Country Code (MCC), Mobile Network Code (MNC), operatore attuale e stato della portabilità.

Casi d'uso:

• Verifica il routing prima di inviare SMS per assicurare la consegna all'operatore corretto
• Rilevare la portabilità del numero per ottimizzare il routing e prevenire ritardi di consegna
• Confermare le informazioni di rete per conformità normativa
• Identificare gli operatori per ottimizzazione intelligente dei tassi
• Validare i numeri prima di campagne SMS in massa

Effettuare una Richiesta

Endpoint

GET https://mnp.agiletelecom.com/services/mnp/number-lookup?msisdn=+39333123123

Autenticazione

Scegli uno di tre metodi supportati:

• Basic Auth: Fornisci il tuo nome utente e password codificati nell'header Authorization
• API Key: Includi la tua API key nell'header X-Api-Key
• OAuth 1.1: Usa autenticazione OAuth 1.1 nell'header Authorization

Parametri Query

Parametro	Tipo	Descrizione
msisdn	stringa	Il numero di telefono da interrogare. Il "+" iniziale può essere omesso, ma devi includere il prefisso del paese. Esempi: +39333123123 o 39333123123

Esempi di Codice

cURL

# Usando l'autenticazione API Key
curl -X GET "https://mnp.agiletelecom.com/services/mnp/number-lookup?msisdn=%2B39333123123" \
  -H "X-Api-Key: YOUR_API_KEY"

# Usando l'autenticazione Basic Auth
curl -X GET "https://mnp.agiletelecom.com/services/mnp/number-lookup?msisdn=%2B39333123123" \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)"

Python

import requests

# Usando API Key
headers = {
    "X-Api-Key": "YOUR_API_KEY"
}

params = {
    "msisdn": "+39333123123"
}

response = requests.get(
    "https://mnp.agiletelecom.com/services/mnp/number-lookup",
    headers=headers,
    params=params
)

data = response.json()
print(f"Operator: {data['operator']}")
print(f"Country: {data['country']}")
print(f"Ported: {data['ported']}")

Node.js

const axios = require('axios');

// Usando API Key
const headers = {
  'X-Api-Key': 'YOUR_API_KEY'
};

const params = {
  msisdn: '+39333123123'
};

axios.get('https://mnp.agiletelecom.com/services/mnp/number-lookup', { 
  headers, 
  params 
})
  .then(response => {
    console.log(`Operator: ${response.data.operator}`);
    console.log(`Country: ${response.data.country}`);
    console.log(`Ported: ${response.data.ported}`);
  })
  .catch(error => {
    console.error('Error:', error.response?.data || error.message);
  });

Risposta di Successo (2XX)

Quando la ricerca ha successo, l'API restituisce informazioni di rete e operatore:

{
  "number": "+39333123123",
  "mcc": "222",
  "mnc": "10",
  "numbertype": "mobile",
  "ported": false,
  "operator": "Vodafone",
  "country": "Italia"
}

Campo	Tipo	Descrizione
number	stringa	Il numero di telefono interrogato in formato internazionale
mcc	stringa	Mobile Country Code attualmente associato al numero
mnc	stringa	Mobile Network Code attualmente associato al numero
numbertype	stringa	Valore fisso "mobile". Indica il tipo di numero
ported	booleano	true se l'abbonato ha trasferito il suo numero a un operatore diverso; false altrimenti
operator	stringa	Nome dell'operatore attuale del numero interrogato
country	stringa	Nome del paese attualmente associato al numero

Risposta Errore Client (4XX)

Quando la richiesta non è valida o mancano parametri obbligatori:

{
  "error_code": 400,
  "error_description": "Specify a msisdn number"
}

Campo	Tipo	Descrizione
error_code	intero	Codice HTTP di errore restituito
error_description	stringa	Descrizione relativa al codice di errore

Errori 4XX Comuni

• 400: Parametro msisdn mancante o non valido
• 400: Formato numero non valido

Risposta Errore Server (5XX)

Quando si verifica un errore lato server:

{
  "error_code": 500,
  "error_description": "Server error"
}

Campo	Tipo	Descrizione
error_code	intero	Codice HTTP di errore restituito
error_description	stringa	Descrizione relativa al codice di errore

Numeri Portati & Routing

Il campo ported indica se l'abbonato ha trasferito il suo numero a un operatore diverso. Usa queste informazioni per decisioni di routing intelligenti, bilanciamento del carico tra operatori e ottimizzazione della consegna. I numeri portati possono instradare attraverso gateway diversi a seconda dell'operatore attuale.

Qual è il Prossimo?

• Protocollo SMPP – Protocollo di connessione persistente per messaggistica ad alto volume
• SMS in Ingresso – Ricevi SMS sul tuo numero dedicato
• Verifica Crediti – Monitora il saldo del tuo account