1 Preparing the Tools

Before getting started, we need to prepare our development envrionment. This basically includes two steps:

1.1 Get your BlueVia Test API Key

First of all you need to register with BlueVia, if you haven’t already done - all you need is a username, a password an email address and (optionally if you want to make use of the real radio network) a mobile number of one of Telefónica´s mobile operators supporting BlueVia, see API country availability

To be able to use BlueVia API’s as a developer you then need to get a BlueVia Test API key. In oAuth terms, this includes the credentials (key and secret) of the Consumer. So, go to Get your Test API key and create your first application:

Get Test API key (Large version)

The important fields are:

We won’t use notifications to recieve SMS and MMS, so no X.509 key is necessary.

After you have submitted your data, you get the following:

Test API key (Large version)

Let’s go through the important parts:

1) Your API key is only valid for testing. If you want to publish your app you need to apply for a so called Commercial Key

API key type: TESTING

2) The oAuth Consumer Key and Secret to be used in oAuth requests to identify you as a developer.

Key: yT11072616762766
Secret: hofF15263457

3) Your keywords for receiving SMS and MMS

As BlueVia supports two environments during developement of an application, there are two different keywords generated from the one you’ve given before:

Test MO keyword: TESTBWTUT01
Sandbox MO keyword: SANDBWTUT01

The sandbox keyword (SANDBWTUT01) is used without any impact on a real radio network and the other one (TESTBWTUT01) can be used for testing purposes in the real radio network (free within your free credits)

4) Your advertising space id, necessary to show BlueVia Ads in your application

Advertising Space id: 10977

1.2 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:

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

easy_install httplib2
easy_install oauth2
easy_install simplejson

Now everything should be ready for the tutorial.