Get access to Telekom’s P-API via VUNK to
accelerate your start-up

VUNK is a
pre-acceleration platform for teams who have an idea, a working prototype or
even a product with traction. To help
teams move faster to build their business, one of the values that VUNK provides
for start-ups is access to its services via P-API.

If you’re serious about validating your idea
and building a solid business out of it, learn below about the types of
services that are available in Telekom’s P-API, some examples of P-API usage
and what you should do to access integration.

What is P-API?

P-API is
short for Public-API – a collection and a security layer in front of Eesti
Telekom services to be used in partner applications to enrich their products
and add convenience features.

What this means: We can authenticate any mobile user’s phone
number and present it to Service Providers (SP). SP’s can then add it to a user
profile for billing or other services.

Example:

/papi/oauth/authorize

{

"phoneNumber":"82828318",

"timeout":60,

"status":"PENDING",

"authToken":"za-A2s69_6ad4dNLVu2hD1t-sHZHtkcT",

"created":"2015-04-29T13:23:21.248+0300”

2. Different
mobile bill payment methods

- An NFC tag and/or QR code sticker

What this means:

The customer
can use their mobile to complete a payment (e.g. in a cafe) and choose their favourite
payment method. It also provides the option of adding other partner payment
methods.

- Voice
call payment

What this means:

The customer
can pay using their mobile by dialling a temporary given number (e.g. news
articles, ice-creams at the beach).

-
Server-side payment

What this means:

After filling
a shopping kart, the SP server sends Telekom a mobile bill payment request with
the customer’s hash-code or phone number

Example: cinema or concert tickets.

3. Mobile
phone positioning via carrier network

What this means:
This makes it possible to request mobile positioning with default access based on
the mobile numbers of your Telekom account or via a request-accept permission system. In addition, this can be used with any device
that has an active SIM card (e.g. modem, controller, etc.).

Examples: SP
can obtain an overview of all numbers that are connected to an aggregated
customer invoice. This service should additionally
be used with internal GPS location services.
This method doesn’t offer exact accuracy, but it works with any
mobile device as long as there is a mobile network coverage. Plus, it doesn’t
consume the user’s battery.

4. Location
based triggers via carrier network

What this means:
These are network-based location triggers. The mobile network operator monitors
trigger rule activation. This service can be activated when: entering a defined
area, leaving a defined area, two phones come close, certain defined area. For
cities, the radius is 100–500 metres, outside the city the radius is 1–5 km.

Examples:
If the user is in a certain area, it can trigger a message to the user’s phone
with offers, etc. (user permission is needed).

5. Roaming
status, data usage and prices

What this means: User-based services in real time that make it possible to
identify if the user is in roaming area, what are the roaming prices, what are the data usage limits and how much
data has been used.

Example:

/papi/rest/roaming/susgInfo/<number>.json

{"emt":true,"prepaid":false,"mccMnc":"248_01f"}

/papi/rest/roaming/operators.json?emt=true&

prepaid=false&mccMnc=248_01f&countryIsoCode=FIN

[{

"operatorCode":"244
12",

"operatorCodeOnBill":"2G",

"operatorName":"DNA Networks Ltd",

"networkType":"GSM
900/1800",

"coverageMap":"http://mobileworldlive.com/maps/netw..

/papi/rest/susgBalanceDetails/accus/msisdn/<number>.json

{"invoices":[{"accus":{"accus":[{

"id":28,

"name":"Roamingu shokkarve limiit",

"amount":60,

"balance":"60.00 €",

"start":"2010-08-26T00:00:00.000+0300"},

{"id":29,

"name":"Andmesidelimiidist välismaal on kasutatud",

"amount":0,

"balance":"0.00
€”.

6. Mobile
account balance and balance details

What this means:
This provides an overview of the balance for a mobile account and the various lines
on the invoice, including usage of data,
voice, messaging and other additional services on your mobile phone bill.

Example:

/papi/rest/susgBalanceDetails/msisdn/<number>.json

{"invoices":[{

"id":"B15042087713",

"type":"CURRENT",

"start":"2015-04-01",

"amount":49.07600000,

"currency":"EUR",

"lines":[{

"code":"GSR",

"description":"Interneti
kasutus/täiendav mahutasu",

"count":222,

"duration":2930197,

"dataVolume":800137,

"amount":0,

7. ACL
(access control list) based remote control and management

What
this means: You can control automated solutions via the Telekom P-API
interface. You simply need to have an input/output controller (your own or buy one
from Telekom) with a SIM card. Telekom will register that SIM+controller as
yours, and then you can send output signals to that controller over the internet
using our P-API. In addition, you can also manage access rights in a timely
manner to manage who else can use your automated solution.

Example:
You are on campus and the rules state that lab doors can only be opened with special
permission from 08:00 to 16:00. Using our P-API solutions you can give students
single-use tickets to open the lab doors during that timeframe.

Are these all P-API Telekom offers?

If you have
an idea or a product that needs Telekom services via P-APIs that are not listed
above, you should still join the VUNK Hackathon. We take every idea and start-up
case by case – if there is synergy with the Telekom business, an interesting
idea with strong business potential and/or a strong team, everything is
possible including a new P-API.

What is the advantage of Telekom’s P-API for
start-ups?

Integration
with Telekom’s services via P-API offers considerable advantage to start-ups –
imagine getting access to hundreds of thousand of paying customers who trust
Telekom as a services provider and regularly pay for the services they
use. How can you build your customers? –
solved. How can you gain trust so customers pay you? – solved. How can you collect
payments regularly? – solved. How can you make it convenient for your customers?
– solved. One P-API that solves so many challenges for start-ups. And this is
just one example.

-
Come
to VUNK hackathon, build a prototype based on your idea or contribute your
skill to other teams with strong ideas. During the hackathon, actively use
mentors from Telekom, Startup Wise Guys and Garage48 to create a working prototype and obtain
initial validation of your idea.

-
At
the end of the hackathon, the mentors will choose 5 teams/winners – these teams
will be able to integrate via P-API as they build their product and business.

During the hackathon
you will access support from Telekom’s P-API guru who will help you adjust the
services to suit your product.

What else do you need to know?

-
As
every product is different, P-API technical integration means working with the technical
team at Telekom to connect your product to Telekom’s systems. It might take
around 2 weeks to finalise the technical integration.

-
To
regulate the business relationship between your start-up and Telekom, a
business agreement will be signed.

And last,
but not least – we created listed P-API’s as a starting point for services that
we see a demand for. We realise that the current list of P-API’s might not
cover some great ideas. So, if you don’t see something on the list, come to the
VUNK Hackathon and pitch your idea – lets build something great together.

VUNK in 2015 & what's up next

As '15 is becoming to an end it's time to look back on our first batch and season. Plus what's our team's ambition for the next year? Read more »

21 Oct

Starting up from inside a corporate

In addition
to the two teams participating in the VUNK Accelerator programme today, quite a
few teams who did not manage to set up their team during the hackathon weekend
in August have independently developing their idea future.

For example Career3, a team from Eesti Telekom, was not able to find developers at a right time, but the energy of the authors of the idea has not run out – quite the opposite.