Upload
anne-bryan
View
216
Download
0
Tags:
Embed Size (px)
Citation preview
Click to edit Master title style
NETWORK API WEBINAR 2011
NETWORK API WEBINAR 2011
http://developer.verizon.com
The Verizon Network API
Click to edit Master title style
NETWORK API WEBINAR 2011
Webinar Overview
• Introduction to the Verizon Network APIs• The On-boarding Process• Simulator Tools• Certification
• API Certification• Application Certification
• Messaging
Click to edit Master title style
NETWORK API WEBINAR 2011
NETWORK API WEBINAR 2011
http://developer.verizon.com
http://developer.verizon.com
Verizon Network APIs API OVERVIEW
Click to edit Master title style
NETWORK API WEBINAR 2011
Open @ Verizon: How It All Fits Together
VerizonWireless
NetworkAPIs
WAC
MobileBrowsers
APIs
DeviceAPIs
NavBuilderInside
Click to edit Master title style
NETWORK API WEBINAR 2011
Network APIs: Overview
• Allows third party application developers to design applications using Verizon network capabilities (the Verizon Wireless Platform)• Network API
– Applications are generally handset independent with no client-side development– Provide a single programming environment to the developer community for many Verizon
services– Provide a common security and policy framework for developers and subscribers– Use Internet standard REST and SOAP Web Services APIs interfaces for third party
application servers to the Verizon Service Control Gateway (SCG)
• At launch, the project supports 20+ Administrative, SMS, MMS and Terminal Location APIs
– Terminal Location APIs support • granular (precise) or AGPS location, and • coarse (cell ID-based) location
– Messaging APIs support Send, Receive and Delivery Receipt to VZW subscribers– Admin APIs support aggregator and enterprise features
Click to edit Master title style
NETWORK API WEBINAR 2011
Network API Architecture
SMPP MM7 MLP
INAP SIP Custom DIA
Network API
Gateway
VDC-Developer Portal• SDK
• Click-through agreements
• Dev support• App submission
• Performance reporting• Credential creation
Back Office & Operations
• CDR Mediation• Rating
• Developer invoicing• Alarms & System
Monitoring
Subscriber Consent Portal
• MyVerizonAccount• User opt in/opt out
management
Web Services over HTTPS
3rd Party App Server
3rd Party App Server
3rd Party App Server
3rd Party App Server
Privacy EngineMDN+APPID+Consent
GPM aGPS client d/l
SMSC MMSC LPS
Network Protection Throttles
Quotas
Check opt-in
Enter/ChangePermissions
Click to edit Master title style
NETWORK API WEBINAR 2011
VDC – Verizon Developer Community
http://developer.verizon.com
Network APIs are an additional platform at
Verizon
Click to edit Master title style
NETWORK API WEBINAR 2011
There is lots of documentation available
Click to edit Master title style
NETWORK API WEBINAR 2011
A Live Demo is to!
Click to edit Master title style
NETWORK API WEBINAR 2011
Developers: Concept Submission
Key part of our effort to achieve
a 14 day certification
process.
Click to edit Master title style
NETWORK API WEBINAR 2011
Consumer Consent Portal-Key Legal Component
Consumers have VZW method to change permissions to protect privacy
Click to edit Master title style
NETWORK API WEBINAR 2011
NETWORK API WEBINAR 2011
http://developer.verizon.com
http://developer.verizon.com
BASIC DEMONSTRATION
Simulator & Tools
Click to edit Master title style
NETWORK API WEBINAR 2011
13
Basic Demonstration
Create developer credentials and log in to:http://developer.verizon.com/
Enter up to two MDNs, answer SMS confirmation to allow MDN use in demo.
Use the VDC web interface to select an MDN for sending a message or getting a location.
You can try the API without creating your own app.
Click to edit Master title style
NETWORK API WEBINAR 2011
14
SMS Demonstration
Select one of your devices from the drop down menu, type a message, hit send to deliver the message.
Click to edit Master title style
NETWORK API WEBINAR 2011
15
MMS Demonstration
Select one of your devices from the drop down menu, hit send to deliver the message.
Click to edit Master title style
NETWORK API WEBINAR 2011
16
Get Location Demonstration
Select one of your devices from the drop down menu, and click “Get Location” to get a location fix of the selected device.
Click to edit Master title style
NETWORK API WEBINAR 2011
NETWORK API WEBINAR 2011
http://developer.verizon.com
http://developer.verizon.com
GETTING STARTED DEVELOPING
Developing
Click to edit Master title style
NETWORK API WEBINAR 2011
Documentation
http://developer.verizon.com/jsps/devCenters/Network_Enablers/index.jsp
Click to edit Master title style
NETWORK API WEBINAR 2011
Verizon Network API Gateways
Click to edit Master title style
NETWORK API WEBINAR 2011
Simulator Credentials Generation
1. Access the Network API Dev Center• Sign-In in to the VDC Developer Portal (http://verizon.developer.com)
• Click Dev Center on the top navigation area and scroll towards bottom to access the Network APIs Dev Center link
2. From there select an appropriate Network API Tutorial under the Technical Resources Section
http://developer.verizon.com/jsps/devCenters/Network_Enablers/Landing_Pages/ne_tech_res_tutorials.jsp
3. Click the link to “Access your simulator credentials”
4. An email with your password is sent to your email address
Click to edit Master title style
NETWORK API WEBINAR 2011
Sticking Point
Make sure Verizon Emails do not go into your spam folder!
– Make sure to add [email protected] into your email client white list.
– If you are not receiving email notification, please let us know: send mail to [email protected]
Click to edit Master title style
NETWORK API WEBINAR 2011
22
Getting Started Bundle
The link “Getting Started Developing for the Network API” to download the Getting Started zip file is available under the Downloads section.
Network_Apps_Getting_Started.zip content– SOAP UI Project (getting_started_soap_ui.xml)
– Java API Generation Scripts (axis and cfx)
Click to edit Master title style
NETWORK API WEBINAR 2011
23
Introduction to SOAP UI
soapUI is a tool for testing Web-Services. Its functions include:
– Inspecting Web Services
– Invoking SOAP and REST Services
Open Source Version is downloadable free from http://www.soapui.org/
Click to edit Master title style
NETWORK API WEBINAR 2011
24
Java API Generation
Download Apache Axis or Apache CXF
Extract the ‘Network_Apps_Getting_Started.zip’ file to a folder on your computer
Run the appropriate script included in the ‘Network_Apps_Getting_Started.zip’ file
– vzw_axis1_sms_client_wsdl2java.sh
– vzw_axis1_sms_client_wsdl2java.bat
– vzw_cxf_sms_client_wsdl2java.bat
– vzw_cxf_sms_client_wsdl2java.sh
The scripts create a Java API on which you can build Network
applications
Click to edit Master title style
NETWORK API WEBINAR 2011
Verizon Network API : Privacy
A subscriber’s opt-in & opt-out settings is at the application level and it is applicable to both messaging and location requests.
The initial location or messaging request triggers a dynamic sms ask to the subscriber’s device.
Subscribers additionally have the ability to enable or disable their opt-in and opt-out setting for each application from their Verizon My Account site
1. A Network Application sends sendSms request2. Server checks whether the target device has given consent to
the calling application3. If the target device has given consent
Server delivers the message Else1. Server sends the opt-in sms message to the target
device (W,A,D) - “A program named ${ApplicationShortName} is trying to locate or contact you....“ - this message cannot be changed
2. Server responds back to the calling application with a 9061 error code
Sample sendSms Flow
Click to edit Master title style
NETWORK API WEBINAR 2011
NETWORK API WEBINAR 2011
http://developer.verizon.com
http://developer.verizon.com
Application On Boarding Process SUBMITTING A CONCEPT
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 1: Register an Alliance
Sign in to developer.verizon.com
Navigate to My Account
Click Alliances under the Go To Market section– If you are already in an alliance, you will be directed to the click-
through agreements page if no contracts has reviewed and signed yet.
Complete the following sections– Company Info
– Business Info
– Contact Info
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 2: Submit A Concept
1. Sign-In
2. Navigate to My Account
3. Click My Applications under the Go To Market section
4. Click ‘Create New Application’ from the left navigation bar
5. Select Network Enabler from drop-down list
6. Complete the requested information in App Info Tab
7. Application Status Changes to Submitted
Click to edit Master title style
NETWORK API WEBINAR 2011
Concept Submission
Click to edit Master title style
NETWORK API WEBINAR 2011
Content Rating Levels
Content considered suitable for ages 7 and above by most parents
Content considered suitable for ages 13 and above by most parents.
Content considered suitable for ages 17 and above by most parents
Content considered suitable for adults 18 and above
For more information, refer:
http://developer.verizon.com/jsps/devCenters/Smart_Phone/Landing_Pages/VerizonContentRatingGuidelines.jsp
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 3: Complete LBS checklist and Export Encryption FormExport control review questionnaire and LBS check, for LBS apps, will be emailed
to the developer after the concept is submitted.
1. To obtain Legal approval complete the Export control review questionnaire and email the scanned signed document to [email protected].
2. To obtain LBS approval ( Location Based Service), complete the LBS Checklist and email the scanned signed document to [email protected]
You also have the option of faxing the signed document to the Legal Department at 908-766-3691.
Please note the effort to include these two forms within concept submission is currently under development.
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 4: Complete the Campaign Approval Form
A Campaign approval form is emailed to after your concept has been submitted. Complete the information in the form and email it back.
Note: This step is only required for applications that use messaging API.
Click to edit Master title style
NETWORK API WEBINAR 2011
NETWORK API WEBINAR 2011
http://developer.verizon.com
http://developer.verizon.com
OBTAINING APPROVAL
Application On Boarding Process
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 1: Concept Evaluation
Application Status changed to SUBMITTED
What happens– Is the application submitted to the correct queue (Network API, NBI, VCAST?)
– Is the description sufficient for downstream reviewers to minimize the RFI process
– Evaluate API traffic forecast
– Highlight content rating
– Notes added for the benefit of downstream reviewers
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 2: Catalog
Application Status changed to CONCEPT EVALUATED
1. You will receive an email notification to login to VDC and capture the application credentials under App tab
2. Certification credentials for Services are listed under your application. It include username or ApplicaitonID and password. These credentials must be used during invoking LBS, SMS and MMS APIs
3. Certification credentials for the Admin/ PPMI are listed under your application. These are also called as Admin credentials. It include admin username and password. Admin credentials must be used for authenticating your access to PPMI
4. Make sure the ApplicationID attribute in PPMI must have username of the Service Credentials
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 3: Legal/Content Standards
Application Status changed to CATALOG APPROVED
What happens
– Applications are reviewed for content rating accuracy and compliance with Verizon's content policy.
– Applications are reviewed for privacy policies.• LBS Approval• Encryption Approval
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 4: Tax
Application Status changed to LEGAL/CONTENT APPROVED
What happens– TAX ID assigned
Click to edit Master title style
NETWORK API WEBINAR 2011
How to Avoid RFIs
• Is this application submitted to the correct queue (Network API, NBI, VCAST?)
• Include clear and comprehensive description of your application, and explain how it works
• Enter the expected number of transactions, explain if your transaction volume is very low.
• Explain the kind of content the application delivers to the user.• This helps with content rating approval
• Only request the API's that the application will use and describe how they are used by the service• If your application uses only LBS API, do not also select the messaging API, and vice
versa.
• Avoid using application name which includes your alliance name• The application name should describe the app.• It should not describe the alliance or the company.• The app name is not editable and cannot be changed.
• Do not apply for multiple applications in one submission• One application at a time
Click to edit Master title style
NETWORK API WEBINAR 2011
NETWORK API WEBINAR 2011
http://developer.verizon.com
http://developer.verizon.com
API & APPLICATION CERTIFICATION
Certification
Click to edit Master title style
NETWORK API WEBINAR 2011
Progress bar and certification
• Progress bar displays Certification Status.
• API Certification runs concurrent with on-boarding tasks.
• Application Certification tests a specific application.
• Is last step before production approval.
Click to edit Master title style
NETWORK API WEBINAR 2011
API Certification
Purpose – Lead developers through a list of test cases to verify that they know
how to properly handle common request success and error conditions
Expectation– Execute each test case
– Review the certification notes and document planned application behavior for the different error conditions
– Provide sign-off on each executed test case
41
Click to edit Master title style
NETWORK API WEBINAR 2011
Successful requests– Successful sendSms request
– Successful get fine location
Runtime faults– getLocation request while
device is turned off
– getMessageDeliveryStatus for an expired request identifier
Request parameter violation– startSmsNotification with an
existing criteria
– sendSms with an invalid senderName
SLA violation– getLocation requested
accuracy below SLA bounds
– sendMessage with an attachment that is too large
Test Case Breakdown
42
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 1: Select API operation
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 2: Review Test Cases
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 3: Execute Tests
Click to edit Master title style
NETWORK API WEBINAR 2011
Checking API Certification Status
Click to edit Master title style
NETWORK API WEBINAR 2011
Application Certification
• Application certification requires you to run through your application to trigger the same usage pattern expected in production.
• You have the opportunity to execute all the edge and normal cases you need to ensure your application is ready for production using the devices white-listed under MDN management.
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 1: Setup MDNs for Certification
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 2: Complete API Selection
Select the specific operation your application will use.
Current Process– Email us all the APIs you expect to use to [email protected].
Short Messaging (SMS) SmsNotificationManagerBinding: startSmsNotification, stopSmsNotification (YES/NO) SendSmsBinding: getSmsDeliveryStatus, sendSms (YES/NO) SmsNotificationBinding: notifySmsDeliveryReceipt, notifySmsReception (YES/NO)
Multimedia Messaging MessageNotificationManagerBinding: startMessageNotification, stopMessageNotification (YES/NO) SendMessageBinding: getMessageDeliveryStatus, sendMessage (YES/NO) ReceiveMessageBinding: getMessage (YES/NO) MessageNotificationBinding: notifyMessageDeliveryReceipt, notifyMessageReception (YES/NO)
Terminal Location (LBS) TerminalLocationBinding: getLocation, getLocationForGroup, getTerminalDistance (YES/NO) TerminalLocationNotificationManagerBinding: endNotification, startGeographicalNotification (YES/NO) TerminalLocationNotificationBinding: locationEnd, locationError, locationNotification (YES/NO)
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 3: Start Certification
• Click the red “Start Certification button”.• You have up to 3 days to run your tests.• Use the Certification Platform username and password• Certification endpoint : cert.verizoncert.com
Click to edit Master title style
NETWORK API WEBINAR 2011
Step 4: Application Certification Approval
At the end of the certification period, we will analyze the CDR log records and server alarms. The analysis will verify the following:
– Log records exist for all the operations stated were part of the application during API Selection
– The application did not invoke methods that were not declared in the API usage section.
– Capture critical server alarms and if necessary request additional information on what triggered the alarms and how the application is developed to avoid them in production.
Click to edit Master title style
NETWORK API WEBINAR 2011
Developers can view current financial reports
Click to edit Master title style
NETWORK API WEBINAR 2011
Production Best Practices
Make sure your applications uses only the APIs selected during
concept submission
Limit the number of API calls to the SLA your application was
assigned.
Click to edit Master title style
NETWORK API WEBINAR 2011
NETWORK API WEBINAR 2011
http://developer.verizon.com
http://developer.verizon.com
Messaging INTRODUCTION
Click to edit Master title style
NETWORK API WEBINAR 2011
Application Approval – Concept Evaluation
Messaging Parameters SMS MMS
Messaging API Topics
Campaign ApprovalForm
Click to edit Master title style
NETWORK API WEBINAR 2011
Application Approval
• Concept Evaluation Phase• Each Application Requires Separate Approval• Campaign Approval Form
– Application Information – MMA Compliant Messaging Flows– Content Rating– Traffic Estimates
• Must be submitted and approved to move the application forward
Click to edit Master title style
NETWORK API WEBINAR 2011
Campaign Approval Form
Application Information • Company Contact Information – Business and
Technical • Customer Support – Toll Free Number and
email• Long or Short Code Information
• CSCA Receipt and Authorization Letter
Click to edit Master title style
NETWORK API WEBINAR 2011
Campaign Approval Form
MMA Compliant Messaging Flows• Opt-in, Opt-out, Help, Error, Subscription
Renewal• Device Discovery (MMS)• Double Opt-in required for Web signup• Wording provided for each message
• Fill in the application specific info into the areas in Green
Click to edit Master title style
NETWORK API WEBINAR 2011
Campaign Approval Form
Application Content Rating•Content Standards Guidelines on the VCAST
section of the VDC•C7+, T13+, YA17+. M18+
Click to edit Master title style
NETWORK API WEBINAR 2011
Campaign Approval Form
Traffic Projections •Worksheet Format •Subscriber Impressions per Month•Subscriber Take Rate - % •Total Messages Per Month•MO and MT Messages per User Per Month•MPS Estimate
Click to edit Master title style
NETWORK API WEBINAR 2011
Messaging Parameters
SMS
• 160 Characters Max
• ASCII Character Encoding
• IA5 and GSM-7 is also supported on most handsets
MMS
• < 1.2MB includes all text, audio, picture and video
• Text – 1000 Characters max with ASCII Format
• Audio – WAV, MP3 or QCELP
• Picture – JPEG, BMP, GIF 87a and PNG
• Video – 3g2, mp4 and 3gp file types with MPEG 4 Simple Profile 0, 1, 2, 3 at 128kbps with QCELP, AMR or EVRC audio
Click to edit Master title style
NETWORK API WEBINAR 2011
Tips for avoiding RFIs
Tips for avoiding an RFI from the submitted Campaign approval form– Complete all the fields in the form
– Provide a short explanation of why the specified content rating was selected
– Provide complete call flows in the Campaign approval form.
– Provide the exact messages that the subscriber will see for all call flows. Wording is given in the Campaign approval form for required messages.
– A double opt-in is required for web enabled applications and any subscription renewal. Provide call flows for the opt-in process.
– Use the notes and guidelines in the Campaign Approval form.
Click to edit Master title style
NETWORK API WEBINAR 2011
Summary
Overview of the Verizon APIs– Introduction to Network APIs
Application On Boarding Process– Submitting a Concept– Obtaining Approval
Simulator & Tools– Basic Demonstration & Tools Available to Developer
Certification– Application & API Certification
Messaging
Click to edit Master title style
NETWORK API WEBINAR 2011
64
Support
Developer Forums for general technical questions related to network API usage.
FAQ provides answers to common API questions.
Email Address for application on-boarding, licensing contractual issues or production issues:
Click to edit Master title style
NETWORK API WEBINAR 2011
NETWORK API WEBINAR 2011
http://developer.verizon.com
http://developer.verizon.com
Q&A
Click to edit Master title style
NETWORK API WEBINAR 2011
NETWORK API WEBINAR 2011
http://developer.verizon.com
Thank You.