SmsWeb logga

SMS gateway web service


Via våra web services kan du enkelt bygga in en SMS tjänst i din egen applikation eller ditt egna webbgränssnitt

Du kan använda dig av en generell SMS funktion eller en anpassad funktion för den typ av SMS du vill skicka.
Med funktionen SendAdvancedxxxSMS30 kan man konfigurera egna parametrar för att skicka ett flertal olika typer av SMS

Snabblänkar till nedanstånde rubriker:

WEB SERVICE
WEB SERVICE via ASP
HTTP GET
SMS typer
HLR (Home Location Register)
HLR anrop
HLR HTTP request respon
HLR EMAIL request respon
SDR (SMS Delivery Report)
SDR via HTTP
SDR ViaE-POST
Dokumentation

Våra web services funktioner hittar du här:
SmartSMS web service 3.0
SmartSMS web service 3.1


WEB SERVICE

För att exempel skicka ett flash SMS använder du dig enklast av funktionen SendSimpleFlashSMS30 med nedanstående parametrar:

OriginatingAddress as string
DestinationAddress as string
UserData as string
ConnectName as string
ContentCategory as string
Charge as string
UserReference as string
UserName as string
PassWord as string


Du får då ett resultat tillbaka med ett antal parametrar från SendSimpleFlashSMS30Result:

UserReference as string
MessageId as string
GateWayId as string
ResponseCode as int
ReasonCode as int
ResponseMessage as string
TemporaryError as boolean
BillingStatus as int
VAT as double
SmsCost as double


WEB SERVICE via ASP

Du kan även använda vanlig ASP kod för att anropa våra web services
För att skicka ett enkelt SMS använder du dig enklast av funktionen SendSimpleSMS30ASP med nedanstående parametrar:

OriginatingAddress as string
DestinationAddress as string
UserData as string
ConnectName as string
ContentCategory as string
Charge as string
UserReference as string
UserName as string
PassWord as string

Du får då ett resultat tillbaka SendSimpleSMS30ASPResponse som en string som du sedan splittrar upp i olika parametrar:

SendSimpleSMS30ASPResult as string


HTTP GET

Du kan även skicka SMS via HTTP get eller post
Du kan enkelt testa genom att fylla i dina uppgifter i länken nedan och klistra in den i webbläsare.

https://www.smartsms.nu/webservice/httpSMS/SendSimpleSMS30ASP?Origina
tingAddress=smartsms&DestinationAddress=0733209918&UserData=TestSMS&C
onnectName=CheapConnect&ContentCategory=sport&Charge=WBSAB&UserRefere
nce=mytest&UserName=myusername&PassWord=mypass


URL anropet returnerar följande parametrar från SMS gateway:

userReference
messageId
gateWayId
responseCode
reasonCode
responseMessage
temporaryError
billingStatus
VAT
smsCost


SMS typer

Man kan skicka SMS av följande typ med SmartSMS 3.0 web service funktioner.

• Enkla SMS
• Avancerade SMS
• Konkatenerade SMS
• Flash SMS
• Push SMS
• Tid styrda SMS
• Premium SMS


HLR (Home Location Register)

Via HLR Lookup service(Home Location Register) kan du validera dina mobilnummer.

I vårt http HLR gränssnitt kan du snabbt slå upp information om ett mobiltelefon
nummer från Home Location Register (HLR) databas.

En HLR rapport kan visa nätverket och landet ett MSISDN tillhör, likasom information som visar om numret har porterats, om det är giltigt, och om det är tillgängligt för ta emot SMS.

'Home Location Register' eller HLR är en central databas som innehåller uppgifter om varje
mobilabonnent som har tillstånd att använda GSM-stomnät.

Varje mobilnät har ett HLR, även om det kan finnas många HLR servrar som skapar ett enda virtuellt HLR.

HLR databasen lagrar information om varje SIM-kort utfärdat av mobiloperatörerna.

Varje SIM har en unik identifierare som kallas en IMSI som är en av de primära nycklarna till
varje HLR post


HLR anrop

I ett HLR anrop anges fem parametrar.

MSISDN: Mobilnumret du vill slå upp. Mobilnumret måste innehålla ett giltigt landsprefix. Exempel,467xxxxxxxxx för Sverige.

ReturnType: Typ av svar för din HLR begäran, H = http returadress, E = e-postadress. Inkludera http:// i din adress om du använder parametern H.

ReturnAddress: Http-adress eller e-postadress måste matcha ReturnType parametern

UserName: SmartSMS username

PassWord: SmartSMS web service password


Svaret från HLRLookup strängen kan innehålla följande parametrar:

QueryId=216784363
MSISDN=46762412957
WebResponse=OK 216784363
QueryId=216784363
Status=Success
NetworkCode=24007
Location=46707963173 SWE
CountryName=Sweden
CountryCode=SWE
Organisation=Tele 2 AB
NetworkName=Tele2Comviq
NetworkType=GSM 900
Ported=No
ErrorCode=
ErrorDescription=
PortedFrom=
PortedFrom2=
Cost=0,207865


HLR HTTP request respon

http://www.yourdomain.com/HLRResponse.ashx
?QueryId=214971101&MSISDN=46733209918&WebResponse=OK
214971101&QueryId=214971101&Status=Success&NetworkCode=24008&Location
=46708000741SWE&CountryName=Sweden&CountryCode=SWE&Organisation=Telenor Sverige
AB&NetworkName=Telenor&NetworkType=GSM 900&Ported=No&ErrorCode=&ErrorDescription=&PortedFrom=&PortedFrom=&Cost=0,20408625



HLR EMAIL request respon

Mail subject:

HLR Query QueryID:214971123 MSISDN=46733209918

Mail body:

QueryId=214971123
MSISDN=46733209918
WebResponse=OK 214971123
QueryId=214971123
Status=Success
NetworkCode=24008
Location=46708000741 SWE
CountryName=Sweden
CountryCode=SWE
Organisation=Telenor Sverige AB
NetworkName=Telenor
NetworkType=GSM 900
Ported=No
ErrorCode=
ErrorDescription=
PortedFrom=
PortedFrom2=
Cost=0,20408625


SDR (SMS Delivery Report)

Det är möjligt att få SDR SMS leverans rapporter skickade till dig via en HTTP-länk eller genom ett e-postmeddelande.
Dessa inställningar kan göras när du har loggat in på ditt konto i SmartSMS.
SMS leveransrapporter signaler statusen på dina skickade SMS.
Du kan då se om ditt SMS har kommit fram till mottagarens mobiltelefon.


SDR via HTTP

Om du använder HTTP länk lösningen måste du ha en webbplats som kommer att svara på SDR pushen från SMSMail.
Adressen före "?" måste ställas in av dig i SmartSMS.se.

Exempel på http sträng push till din SDR adress:

http://www.mysiste.se/SDRReceiver.ashx?GateWayId=1-11843444839&DestinationAddress=46733209918
&Operator=BusinessConnect&ReasonCode=0&ReasonCodeinfo=Delivered
&ReasonCodeDescription=Message delivered to handset.&StatusCode=0&StatusText=
&OperatorTimestamp=20110216 12:45:44&TimeStamp=20110216 12:45:44



SDR Via E-POST

Du kan också få din SDR via e-post.
Den mottagande e-postadressen måste ställas in av dig i SmartSMS.se

Subject:

SmartSMS SDR: 1-11844586058

SDR email sample:

GateWayId=1-11844586058
DestinationAddress=46733209918
Operator=BusinessConnect
ReasonCode=0
ReasonCodeinfo=Delivered
ReasonCodeDescription=Message delivered to handset.
StatusCode=0
StatusText=
OperatorTimestamp=20110216 15:40:25
TimeStamp=20110216 15:40:25



Dokumentation

Läs mer om funktionerna i nedanstånde dokument:
SmartSMS30_WEB_SERVICE.pdf
SmartSMS31_WEB_SERVICE.pdf


Wireless Business Solutions AB Telefon +46 (0)31 209919 Copyright © WBS AB
Norra Ågatan 10 Fax +46 (0)31 3390799 Version SmartSMS 3.2.2
416 64 GÖTEBORG E-post support@smartsms.se Sitemap