MRS Service (Network Lookup) e Portability Documentazione tecnica Interfaccia QUERY

Transcript

1 MRS Service (Network Lookup) e Portability Documentazione tecnica Interfaccia QUERY MRS v Page 1/6

2 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 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 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 MRS v Page 2/6

3 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 CET Central European Time Fuso orario del continente longitude String E latitude String N msisdn String Coordinate della capitale Mobile Subscriber Integrated Service Digital Networknumber national String 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 v Page 3/6

4 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 CET Central European Time Fuso orario del continente longitude String E latitude String N Coordinate della capitale MRS v Page 4/6

5 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 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 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 v Page 5/6

6 Qui di seguito vi è un esempio della richiesta ESEMPIO 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 Numero telefonico MCC String 222 Mobile country code MNC String 10 Mobile network code Description String Italy VODAFONE Operator Name MRS v Page 6/6