Crea il tuo assistente AI con lo Stregatto (open source python framework)
Using the GSMA OneAPI Gateway
1. GSMA OneAPI Gateway
It's a Cross Carrier play
Here's where APIs get really exciting!
Confidential 1
2. OneAPI — Registration
1. Register at:
https://oneapi-gw.gsma.com
2. Confirm email
3. Log in
Provides access to dashboard and developer
documentation
Confidential 2
3. Creating an Application
Click on
Company Name
Log In Go to Dashboard
in Developer
Profiles
Complete the Click ‗Create
Enter application form and click Application‘
name ‗create
application‘ Bottom of page
Add test phone Click ―Create
numbers Application‖
Confidential 3
4. Manage Application
You can find this page
from the Dashboard:
1. Go to Dashboard
2. Click on the company
name link below
Developer Profiles
(bottom of page)
3. Click on the Manage
Application button
next to your
application name.
Confidential 4
5. Application Specific Info
Note the two application profile buttons:
―Endpoints‖ — Important application settings necessary
for using the APIs
―Manage Whitelist‖ — Phone numbers for testing with
APIs
Confidential 5
6. Necessary Information
Application Profile — Endpoints
– Application User Name & Application Password
– The URI prefixes (excluding the ―.*‖ suffix, shown, if
any) for each API-type
PDF documents describing API sets‘ usage
– ―Common Information Guide‖ some error codes
– ―Sandbox Data service‖ prereq for Payments APIs
described in ―Payment Developer Guide‖
– ―Privacy Developer Guide‖ prereq for Location APIs
described in ―Terminal Location Developer Guide‖
Confidential 6
7. API Protocol
HTTP / REST (mostly)
HTTP Basic Access Authentication
Form-data or JSON Input
XML or JSON output
Some APIs Accept Callback URIs
Confidential 7
10. APIs Supported
Sending SMS from short code to phone
Receiving SMS (to short code)
Location (latitude/longitude)
Payment — Charge to phone bill
Confidential 10
11. Send SMS to Phone
1. Add test phone number to Whitelist
2. Create request JSON in a file
3. Call HTTP
4. Receive Transaction ID
Use Transaction ID to check delivery status
Confidential 11
15. Location Query
1. Whitelist phone number
2. Get permission to retrieve position
(once only, per app, privacy API)
3. User authorizes
4. Retrieve user‘s location
Confidential 15
17. Location API Example
1. Add phone number to Whitelist
2. Ask permission to retrieve location
POST https://oneapi-gw.gsma.com/privacy HTTP/1.1
Content-Type: application/x-www-form-urlencoded
address=tel%3A%2B16045551212&callbackUrl=http%3A%2F%2
Fwww.example.com
Confidential 17
18. Location API Example
3. User responds to text with ―ALLOW‖
4. Check status (or use callback)
https://oneapi-gw.gsma.com/privacy?address
=tel%3A%2B16045551212<?xml version="1.0"
encoding="UTF-8"standalone="yes"?>
<PrivacyResponse status="ALLOWED"/>
All future location requests are enabled for the app
for that user.
Confidential 18
20. Payment API
1. Create Payments Sandbox Group (if not
already created)
2. Add ―subscribers‖ to the group, by phone
number
3. Call Payment API to ―charge‖ money
4. Call Payment API to detect status
Confidential 20
21. Payment Example
1. Create Payments Sandbox Group
https://oneapi-gw.gsma.com
/sandboxdataservice/Payment_Sandbox
2. Add phone numbers to group
https://oneapi-gw.gsma.com
/sandboxdataservice/Payment_Sandbox/tel%3A
%2B16045551212
Confidential 21
23. Payment Example
2. Call Payment function API
https://oneapi-gw.gsma.com/sandboxpayment/
2_1/payment/tel%3A%2B16045551212/transactions/amount
Confidential 23