HLR-lookup (Network Query)
Een Network Query kan gedaan worden op het mobiele netwerk. Hiermee kan er real-time gekeken worden tot welke operator een mobiel nummer (MSISDN) behoort. Deze dienst wordt ook wel "Network Look-up Service" of "HLR lookup" genoemd. Een Network Query kan bijvoorbeeld handig zijn om erachter te komen bij welke operator een geporteerd nummer (Mobile Number Portability, MNP) hoort om zo de goedkoopste SMS-routering te gebruiken.
Aanvragen van HLR
Verstuur de volgende aanvraag:
http://www.mollie.nl/xml/hlr/?username=[username] &password=[password]&recipients=[recipient]&reference=[referentie]
Let op! Bulk-aanvragen (dus nummers gescheiden met een komma) worden niet geaccepteerd.
Geef een eigen referentie mee, deze wordt later gebruikt om het resultaat bij uw systeem te melden. U kunt een URL opgeven op uw instellingen-pagina waar wij de HLR-resultaten moeten droppen.
Ontvangen van het HLR-resultaat
Na enige tijd (enkele seconden tot een minuut) ontvangt u op het URL die u heeft ingesteld op de instellingen-pagina een aanvraag terug met daarin de netwerkinformatie van het opgevraagde nummer.
Terugkoppeling van HLR-resultaat:
http://www.domein.nl/sms/hlr.php?reference=123456789 &recipient=31612345678&status=60&network=204160
De status-parameter die u ontvangt bij de rapportage, correspondeert met een van de volgende statussen:
- 60 - aanvraag gelukt
- 61 - aanvraag gelukt, MSISDN/recipient afwezig
- 62 - aanvraag gelukt, MSISDN/recipient bestaat niet
- 69 - aanvraag gefaald
De network-parameter is de 'mobile network code' (MNC), een volledige lijst met mobile network codes is te vinden op deze Wikipedia-pagina.
