We strongly recommend using HTTPS when accessing our endpoints. However, we do support the use of HTTP for highly latency-sensitive use-cases.
Load latency: This can vary between 50 milliseconds and half a second, depending on your client location and Internet speed. It should generally be loaded by the time your DOM is ready, if you put the snippet in the HEAD of the page.
Check availability: You can load cdn.petametrics.com/.js to verify that the CDN is working.
Uptime: Our CDN has never gone down globally. In the worst case, if an edge location is down, content may take more time to load from a different location.
Our API endpoint for sending activity and inventory is https://api.petametrics.com. This endpoint is used for direct inventory insertions (using the POST endpoint), inventory retrieval (using the GET endpoint) and inventory deletion (using the DELETE endpoint).
Check availability: To check that the endpoint is up, you can query https://api.petametrics.com/@status at that endpoint, and should receive a 200 "ok" response if it is up
Our query endpoint is https://query.petametrics.com. It is in three regions:
- US West (Oregon)
- US East (South Carolina)
- EU West (Belgium)
Load latency: Server-side latency varies between 75 and 175 milliseconds, depending on the complexity of the query and other features that vary based on the organization. Latency for most queries should be less than 125 milliseconds. You need to add to this the round-trip time, that can vary between 50 milliseconds and a second. Round-trip times can be much lower for a server-side integration if your infrastructure is co-hosted in the same region.
If you have custom needs that require better latencies, we can implement a solution that reduces the server-side latency, and can work with you on a server-side integration so as to reduce round-trip time. Please contact Support for more questions around latency.
Check availability: You can query https://query.petametrics.com/@status at that endpoint, and should receive a 200 "ok" response if it is up.
Uptime: Our global API endpoint, as well as our regional endpoints, almost never go completely down (in a typical month, they don't go down at all).
We occasionally (a few times a month) have temporarily degraded performance in a region, defined as follows:
- More than 1 in 1,000 queries timing out, and/or
- Queries taking twice as long as usual, or longer (more than a few percentage of queries taking over 250 milliseconds)
We automatically detect and respond to degraded performance by scaling up infrastructure, and our team is notified if automated recovery methods fail.