Before You Begin
In order to work with our Wireless Network Services APIs and tools, you will need an API key. Obtain your key from the ThingSpace Developer portal. You will also need a connectivity plan in order to provision devices and activate them on our network.
Review these checklists to be sure that you're ready to start.
- Sign up or sign in for a ThingSpace Developer Account to obtain your API keys.
- Sign up or sign in for a ThingSpace Connectivity Account. (We have Starter Accounts and Enterprise Accounts available)
- Register your outgoing IP address with the Verizon M2M Data Center white-listing system. As part of our security strategy, the ThingSpace Platform only responds to requests from IP addresses that are on the Verizon M2M Data Center white list. See IP addresses in Callback Security section below.
- Obtain the account name and UWS API login credentials for your account. (More on login credentials)
- Request the SDK.
- Login to ThingSpace with your Starter or Enterprise connectivity account credentials to provision service for at least one M2M device on the Verizon Wireless network and enable M2M functionality for that device.
Once you have everything set up, you may want to start with our tutorials on creating a client application in C# and Visual Studio,
Java and Eclipse, or Java and NetBeans.
Your application must log in and obtain a session token prior to sending any API requests, as described in About Login Credentials. In addition, all requests must be encrypted with TLS v1.2 or greater protocols.
To increase security when receiving callback messages from the Verizon M2M Data Center, you can implement these protocols:
Enable white-listing on your firewall or front-end server and add the Verizon M2M Data Center IP addresses to the white
list. This will allow your servers to reject requests from other IP addresses. The addresses are:
- 126.96.36.199/29 (range: 188.8.131.52 - 184.108.40.206)
- 220.127.116.11/29 (range: 18.104.22.168 - 22.214.171.124)
Install a one-way certificate and enable HTTPS. You must use a certificate from a third-party certificate service;
a self-signed certificate will not work. The Verizon M2M Data Center will check the certificate at the start of every
session to verify that the registered IP address leads to your servers.
Restrict your server to only accept requests that use TLS 1.2 protocol or greater. The Verizon ThingSpace Platform will not
send callback requests using any other protocol.