ITA – Mobile Number Portability

MNP – Mobile Number Portability #

E’ possibile richiedere informazioni di portabilità sui numberi mobili tramite HTTP Rest Api attraverso una chiamata così strutturata:

• URL: https://mnp.agiletelecom.com/services/mnp/number-lookup?msisdn=number
• METODO: GET
• AUTENTICAZIONE: Basic / Api-Key / OAuth1.1 (tutte nell’header)

CAMPO	TIPO	NOTE
number	string	Il numero di telefono per il quale si richiede l’informazione. Si può omettere il “+” iniziale, ma occorre comunque specificare anche il prefisso internazionale.

La risposta sarà in formato JSON:

• 2XX (messaggio accettato dal server)

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

CAMPO	TIPO	NOTE
number	string	Il numero di telefono per il quale sono state richieste informazioni
mcc	string	Mobile Country Code attualmente associato al numero richiesto
mnc	string	Mobile Network Code attualmente associato al numero richiesto
numbertype	string	Stringa fissa “mobile”. Indica il tipo di numero richiesto
ported	boolean	Indica se l’operatore attuale del numero richiesto differisce dall’originale
operator	string	Operatore attuale del numero richiesto
country	string	Paese attualmente associato al numero richiesto

• 4XX (richiesta rifiutata per errori formali nei parametri)

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

CAMPO	TIPO	NOTE
error_code	integer	Codice dell’errore HTTP ritornato
error_description	string	Descrizione relativa al codice d’errore ritornato

• 5XX (richiesta non processata per errori lato server)

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

CAMPO	TIPO	NOTE
error_code	integer	Codice dell’errore HTTP ritornato
error_description	string	Descrizione relativa al codice d’errore ritornato