I am happy to announce the release of version 2 of the pMetrics API.
It has a unique URL from the old version to ensure that existing applications continue to function as expected. There are a few changes that are not backwards compatible, although these changes are very minor and should not take more than a few minutes to implement within existing applications. Juicy details are available in the API documentation, but here’s a brief run down of what’s new:
* new “actions-list” data type, includes ability to filter by session_id
* relative date formats (“5 days ago”, “last 10 days”, “last month”, etc)
* a limit of “all” for every data type
* shorter cache times
* more consistent naming schemes for both data types and data values
* null values excluded by default (saves memory and bandwidth, can be disabled)
* new “total time” data type
* some new parameters: session_id, null_values, app
* CSV output (this was supported before, but undocumented)
* and more…
The API is now officially out of “beta” status. When it was first released many months ago, it was stated that there would be some restrictions for non-Pro users at a later date. (Pro is our upper tier premium package). These restrictions have changed to be much more relaxed, but please note that the following restrictions are now in effect for all non-Pro users:
* Limited to 100 results per request
* Limited to “today” and “yesterday”
* 30 minute cache times
An important note to developers: The “Base API URL” is no longer provided or supported. This is to ensure that you are always in control of which version of the API is being used with your application, since the API version is encoded within the URL. More information about this is in the docs.