The ThingSpace Connectivity Management API lets application developers manage the connectivity of M2M devices deployed on the Verizon Wireless network. You can use the API to integrate service provisioning and monitoring tasks with enterprise back-office systems. Some of the supported tasks include:
For a description of all Connectivity Management API requests and responses, see the API Reference pages.
When operating 4G devices (e.g., devices with CAT M1 or NB LTE RF communication modules) that conserve power by using sleep modes, you must ensure with the device OEM (e.g., OEM-provided tools that can configure device sleep mode settings) that the sleep mode settings are set to the desired values. Please see the About Device Reachability section under the “Working with Verizon Wireless” menu. Please contact your Verizon account representative for more assistance with such devices. Device Reachability APIs provide the ability for enterprise applications to be notified when devices become reachable (or unreachable) for data communications (i.e., when they wake up from sleep states or fall back to sleep. Please see the API Reference for Device Reachability APIs for more details.
You can follow these general steps to get started with the Connectivity Management API:
If you have a ThingSpace IoT Marketplace plan, follow these instructions to get started using the Connectivity Management API.
The Connectivity Management API requires a special set of credentials that allows you to manage IoT devices through an API. These credentials are used when starting a Connectivity Management session with an API, and allows you to retrieve the VZ-M2M Token.
The API user page appears
Your application must send an API token in the header of every API request. We use the OAuth2 “client credentials” grant type, and we require that the application key and secret are Base64 encoded. To obtain an API token:
curl -X POST -d "grant type=client_credentials" -H "Authorization:Basic BASE64_ENCODED_APP_KEY_AND_SECRET" -H "CONTENT-TYPE: application/x-www-form-urlencoded" "https://thingspace.verizon.com/api/ts/v1/oauth2/token"
The response contains a token that you must include in the header of all API requests. The token will be valid for one hour from when it was first issued, and any further token requests during that hour will return the same token.