Keywords: MultiMarkdown, Markdown, XML, XHTML, XSLT, PDF
CSS: css/print.css CSS: css/doc-less.css

Feel free to download and mess around with this app, it may or may not be updated regularly, when it is we will publicise on our twitter feed (@BlueVia)

Get your Python environment prepared

There is little to do with python. The tutorial has been prepared with Python 2.6. Further on we need three additional python modules:

• httplib2: Makes life with http calls easier
• oauth2: The actual oauth library
• simplejson: Makes life with JSON easier

The easiest way to get these is easy_install from python setup tools:

	easy_install httplib2
easy_install oauth2
easy_install simplejson

Sample usage of all BlueVia python routines

Some personal settings

	myMobileNumber = "44xxxxxxxxxx"
myShortcode = "445480605" # UK
myAdSpaceId = "xxxxx"
# App with all API's ticked my3leggedConsumer = 'xxxxxxxxxxxxxxxx' #Your developer consumer key
my3leggedSecret = 'xxxxxxxxxxxx' #Your developer consumer secret
# App with advertising only
my2leggedConsumer = 'xxxxxxxxxxxxxxxx'
my2leggedSecret = 'xxxxxxxxxxxx'

oAuth Dance

	import bluevia
import webbrowser o3 = bluevia.BlueViaOauth(my3leggedConsumer, my3leggedSecret)
url = o3.fetch_request_token()[1]
webbrowser.open(url) # Opens authorisation url in browser
reqtok = str(raw_input("Enter pin code")) #asks for authorisation pin and saves it in variable
o3.fetch_access_token(reqtok)
o3.saveAccessToken(myMobileNumber + "_acctok.pk1")

Send SMS and track delivery

	s = bluevia.BlueViaOutboundSms()
s.loadAccessToken(myMobileNumber + "_acctok.pk1")
r = s.sendSMS([myMobileNumber], "Hello BlueVia")
s.deliveryStatus(r[1])

Note: to use the real radio network call (this holds for all BlueVia calless below):

	s = bluevia.BlueViaOutboundSms(sandbox="")

Receive SMS (first send one or more SMS to the sandbox shortcode)

	s.sendSMS([shortcode], "SANDBWTUT01 BlueVia")
si = bluevia.BlueViaInboundSMS()
si.loadAccessToken(myMobileNumber + "_acctok.pk1")
si.receiveSMS(shortcode)

Send MMS

	m = bluevia.BlueViaOutboundMms()
m.loadAccessToken(myMobileNumber + "_acctok.pk1")
m.sendMMS(myMobileNumber, "Hello Multimedia BlueVia", \
["Message\n Number 1", "Yet another\n Message"], \
["samples/atextfile.txt", "samples/image.jpg"])

Receive MMS and retrieve the attachemnts (first send one or more MMS to the sandbox shortcode)

	m.sendMMS(myShortcode, "SANDBWTUT01 BlueVia Multimedia", \
["Message\n Number 1", "Yet another\n Message"], \ ["samples/atextfile.txt", "samples/image.jpg"])
mi = bluevia.BlueViaInboundMMS()
mi.loadAccessToken(myMobileNumber + "_acctok.pk1")
r = mi.receiveMMS(myShortcode)
mid = r[1]['receivedMessages']['messageIdentifier']
mi.retrieveAttachments(myShortCode, mid)

User Context API

	u = bluevia.BlueViaUserContext()
u.loadAccessToken(myMobileNumber + "_acctok.pk1")
u.getUserInfo()

Location API

	l = bluevia.BlueViaLocation()
l.loadAccessToken(myMobileNumber + "_acctok.pk1")
l.locateTerminal()

Advertising API (3 legged oAuth)

	a3 = bluevia.BlueViaAds(myAdSpaceId)
a3.loadAccessToken(myMobileNumber + "_acctok.pk1")
a3.getAd_3l()

Advertising API (2 legged oAuth)

 import oauth2 as oauth
a2 = bluevia.BlueViaAds(myAdSpaceId)
a2.setConsumer(oauth.Token(	my2leggedConsumer, my2leggedSecret))
a2.setDebug(debugFlag)
a2.getAd_2l("GB")

Payment API

 p = bluevia.BlueViaPayment(my3leggedConsumer, my3leggedSecret)
amount = 199 # no float, 199 means 1.99 EUR
currency = "EUR" # EUR, GBP, ...
# In sandbox any strings, commercially the service Id / Name given by the Mobile Payment Partner
serviceId = "123456" serviceName = "My Digital Good" p.fetch_request_token(amount, currency, serviceId, serviceName)
# When finished copy verifier, e.g 176539
p.fetch_access_token("176539")
p.savePaymentInfo("payment.pkl") # optional, token valid for 48 h
p.loadPaymentInfo("payment.pkl") # optional
result = p.issuePayment()
txid = result[1]["methodResponse"]["result"]["paymentResult"]["transactionId"]
p.checkPayment(txid)