Before getting started, we need to prepare our development envrionment. This basically includes two steps:
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:
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:
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 |
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.