Learn how to work with the powerful PERSCOM API.
Jumpstart your integration using our official Postman collection.
The PERSCOM API is the backbone that allows PERSCOM to function and deliver the services you’ve come to enjoy. The API also allows you to integrate your PERSCOM.io data with third-party services and applications.
View the OpenAPI specification file.
The PERSCOM API is built using a RESTful interface. A request to the PERSCOM API requires a HTTP GET
, POST
, PUT
, PATCH
, orDELETE
request along with an API key to an available URL endpoint. A collection of all available endpoints can be found under theEndpoints
folder.
Requests to the PERSCOM API require the user to verify who they are. The API expects an API Key to be passed via a Bearer
token in theAuthorization
header of your HTTP request. API Keys can be managed under your PERSCOM dashboard.
In an effort to always provide a powerful and robust API, we’ve adopted a versioning system to help us roll out regular updates. The API version is defined as a path parameter in the URL. For example:
Replace {version}
with the API version. The current API version is v2
.
The PERSCOM API is backed by a worldwide CDN and cache that allows us to deliver your requests quicker no matter where they originate from. On the dashboard, we handle updating the cache whenever you make a change to your data to make sure you always have access to the most up-to-date data available. Sometimes, this data can get out-of-sync and a cache purge is necessary. At anytime if you feel the data you are receiving from the API is stale, you can initiate a cache purge from the API section of your PERSCOM dashboard.
Below are examples of requests made to the PERSCOM API using different software solutions.
Learn how to work with the powerful PERSCOM API.
Jumpstart your integration using our official Postman collection.
The PERSCOM API is the backbone that allows PERSCOM to function and deliver the services you’ve come to enjoy. The API also allows you to integrate your PERSCOM.io data with third-party services and applications.
View the OpenAPI specification file.
The PERSCOM API is built using a RESTful interface. A request to the PERSCOM API requires a HTTP GET
, POST
, PUT
, PATCH
, orDELETE
request along with an API key to an available URL endpoint. A collection of all available endpoints can be found under theEndpoints
folder.
Requests to the PERSCOM API require the user to verify who they are. The API expects an API Key to be passed via a Bearer
token in theAuthorization
header of your HTTP request. API Keys can be managed under your PERSCOM dashboard.
In an effort to always provide a powerful and robust API, we’ve adopted a versioning system to help us roll out regular updates. The API version is defined as a path parameter in the URL. For example:
Replace {version}
with the API version. The current API version is v2
.
The PERSCOM API is backed by a worldwide CDN and cache that allows us to deliver your requests quicker no matter where they originate from. On the dashboard, we handle updating the cache whenever you make a change to your data to make sure you always have access to the most up-to-date data available. Sometimes, this data can get out-of-sync and a cache purge is necessary. At anytime if you feel the data you are receiving from the API is stale, you can initiate a cache purge from the API section of your PERSCOM dashboard.
Below are examples of requests made to the PERSCOM API using different software solutions.