The Tenant API Code is the unique identifier that will allow you to request access to the correct tenant.
Depending on your goals, you may begin by working with the Sandbox Tenant (with Tenant API Code embedded) as you experiment with our APIs to see how sample data works with your code. If you are working with a specific customer (or developing for internal use) and would like to connect to real customer data from Plantronics Manager Pro, you will need to request and receive authentication to use this identifier.
API regional host URLs
For each region, we have a unique API host url. All of the data in each of the regions is completely isolated for Data Privacy policies that Plantroncis PM Pro guarantees to its customers. So, an app created in one region will not be available in another region. So, it has to be registered for each region separately. Once you have identified which region the tenant you will be integration your app with, please refer the following section to identify the region that you will need to call to do one of the following:
As an example, to trasform your request to call version status report get request for the Sandbox enviroment, you will be calling to AU:
Curl
curl -v -X GET https://plantronics-sandbox.apigee.net/reports/assets/tenant/{tenantApiCode}/versionstatus/software
will tranform to for Australia:
curl -v -X GET https://oda-api-au.plantronicsmanager.com/reports/assets/tenant/{tenantApiCode}/versionstatus/software
NOTE: If you are using sandbox, you DO NOT need to request authorization for an app. Authorization is disabled for an appId (still an appId header is required) since this environment is for development purposes only for app developers. If you are using Developer tenant, please use the staging host url. Developer tenants are hosted in NA.
---
Next Step: Register your App
Depending on your goals, you may begin by working with the Sandbox Tenant (with Tenant API Code embedded) as you experiment with our APIs to see how sample data works with your code. If you are working with a specific customer (or developing for internal use) and would like to connect to real customer data from Plantronics Manager Pro, you will need to request and receive authentication to use this identifier.
Sandbox Tenant API Code
The Tenant API Code is pre-embedded for you in each API provided. In the event that the code does not display correctly, the Sandbox Tenant API Code is af0813e6-81c0-4a77-89d2-3338d0277c42.
Customer Tenant API Code
For a customer with a Plantronics Manager Pro tenant, the Tenant API Code can be found in Plantronics Manager Pro in the following location:
API regional host URLs
For each region, we have a unique API host url. All of the data in each of the regions is completely isolated for Data Privacy policies that Plantroncis PM Pro guarantees to its customers. So, an app created in one region will not be available in another region. So, it has to be registered for each region separately. Once you have identified which region the tenant you will be integration your app with, please refer the following section to identify the region that you will need to call to do one of the following:
- Request authorization for an app with a PM Pro tenant
- Use APIs to query specific tenant's data in that region or use Streaming APIs
|
Region
|
API Regional Host URL |
| Australia | https://oda-api-au.plantronicsmanager.com |
| Singapore(Any APAC tenant) | https://oda-api-ap.plantronicsmanager.com |
| North America | https://oda-api-na.plantronicsmanager.com |
| Europe | https://oda-api-eu.plantronicsmanager.com |
| Staging (Developer tenant) | https://oda-staging.plantronicsmanager.com |
As an example, to trasform your request to call version status report get request for the Sandbox enviroment, you will be calling to AU:
Curl
curl -v -X GET https://plantronics-sandbox.apigee.net/reports/assets/tenant/{tenantApiCode}/versionstatus/software
will tranform to for Australia:
curl -v -X GET https://oda-api-au.plantronicsmanager.com/reports/assets/tenant/{tenantApiCode}/versionstatus/software
NOTE: If you are using sandbox, you DO NOT need to request authorization for an app. Authorization is disabled for an appId (still an appId header is required) since this environment is for development purposes only for app developers. If you are using Developer tenant, please use the staging host url. Developer tenants are hosted in NA.
---
Next Step: Register your App