MRS Service (Network Lookup) e Portability Documentazione tecnica Interfaccia QUERY MRS v6.0.0 - Page 1/6
Che differenza c'è tra MRS e Portability? MRS significa MSISDN Resolver Service ed offre la possibilità di ricavare informazioni su un dato numero di utenza mobile (MSISDN). In particolare le informazioni che si possono ricevere sono le seguenti: Nome dell'operatore Nazionalità Locazione Fuso orazio Portabilità Stato dell'apparecchio (Online/Offline) Il servizio Portability invece permette di visualizzare solamente l'operatore reale di un numero. Come si invia una richiesta MRS? La richiesta va inoltrata tramite un semplice metodo QUERY/GET al seguente indirizzo URL http://www.agiletelecom.com/mrs/mrsclient.php Aggiungendo i seguenti parametri RICHIESTA MRS Nome Tipo Esempio Descrizione USER String testaccount Nome utente del tuo account PASSWORD String mypassword Password del tuo account NUMBER String +393381234567 Numero da controllare in formato internazionale (ATTENZIONE: i nomi dei parametri devono essere scritti in maiuscolo, poichè la pagina PHP è case sensitive) Qui di seguito vi è un esempio della richiesta ESEMPIO http://www.agiletelecom.com/mrs/mrsclient.php?user=testaccount&password=mypassword&number=+393381234567 MRS v6.0.0 - Page 2/6
Che cosa riceverò come risposta? Il servizio risponderà con un codice XML contenente i seguenti campi Nome Gruppo Account operator country msisdn presence location RISPOSTA POSITIVA XML-Tag Tipo Esempio Descrizione User String testaccount Nome utente del tuo account Credit String 1500 Credito residuo nell'account id Integer 25 ID dell'operatore name String Vodafone Nome dell'operatore alias String Omnitel Pronto Nome alternativo dell'operatore mcc Array of Integers 222 Mobile country code mnc Array of Integers 10 Mobile network code isocode String it Codice ISO della nazione del numero name String Italy Nazionalità del numero capital String Rome Capitale della nazione di appartenenza del numero zone Short 4 ID del continente zone_name String Europe Nome del continente timezone Array of Strings +0100 CET Central European Time Fuso orario del continente longitude String 12.833333333333 E latitude String 42.833333333333 N msisdn String +393381234567 Coordinate della capitale Mobile Subscriber Integrated Service Digital Networknumber national String 03381234567 Numero in formato internazionale prefix Short 338 Prefisso del numero ported Boolean 1 ported_from_id Integer 24 status String 1 validity Integer 10 isocode String it Valore booleano che indica se il numero è portato o meno ID dell'operatore originale del numero Flag che indica se il numero è al momento acceso e raggiungibile Validità delle informazioni in secondi Codice ISO della nazione in cui il numero è locato name String Italy Nome della nazione in cui il MRS v6.0.0 - Page 3/6
numero è locato capital String Rome Capitale della nazione zone Short 4 ID del continente zone_name String Europe Nome del continente timezone Array of Strings +0100 CET Central European Time Fuso orario del continente longitude String 12.833333333333 E latitude String 42.833333333333 N Coordinate della capitale MRS v6.0.0 - Page 4/6
RISPOSTA NEGATIVA Codice Errore Tipo di Errore Descrizione/Risoluzione 20 Missing parameter USER/PASSWORD/NUMBER 30 Wrong USER/PASSWORD Almeno un parametro della richiesta è mancante. Controllare i parametri Utente non trovato o password non corretta. Controllare user e/o password 31 Not enought credit L'account non ha abbastanza credito per la richiesta 32 Not allowed 40 Wrong NUMBER format 52 Absent subscriber Si sta utilizzando un test account, il quale non è abilitato all'uso del servizio Sintassi del numero errata. Controllare la sintassi del numero. (Utilizzare formato internazionale preceduto da +, 00 o %2B) Il numero è irraggiungibile o spento. Riprovare più tardi 54 Unknow subscriber Il numero non esiste Come si invia una richiesta di Portability? La richiesta va inoltrata tramite un semplice metodo QUERY al seguente indirizzo URL http://www.agiletelecom.com/mrs/portability.asp Aggiungendo i seguenti parametri RICHIESTA MRS Nome Tipo Esempio Descrizione USER String testaccount Nome utente del tuo account PASSWORD String mypassword Password del tuo account NUMBER String +393381234567 Numero da controllare in formato internazionale. E' possibile specificare più numeri separandoli con il carattere ; (ATTENZIONE: i nomi dei parametri devono essere scritti in maiuscolo, poichè la pagina PHP è case sensitive) MRS v6.0.0 - Page 5/6
Qui di seguito vi è un esempio della richiesta ESEMPIO http://www.agiletelecom.com/mrs/portability.asp?user=testaccount&password=mypassword&number=+393381234567 Che cosa riceverò come risposta? Il servizio risponderà con un codice XML contenente i seguenti campi Nome Gruppo RISPOSTA POSITIVA XML-Tag Tipo Esempio Descrizione NumXXX - String Num001 Numero progressivo Number String +393381234567 Numero telefonico MCC String 222 Mobile country code MNC String 10 Mobile network code Description String Italy VODAFONE Operator Name MRS v6.0.0 - Page 6/6