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 |
