Conventions shared by every PerspioTalk API.
PerspioTalk is a set of REST APIs over HTTPS, one for each area of Perspio: Assets, Devices, Reports and so on. Each API has its own version, and they all share the conventions on this page and the pages under it.
| Topic | In short | Details |
|---|---|---|
| Base URLs | https://talk.perspio.io (AU) and https://us-talk.perspio.io (US) | Base URL |
| Authentication | A bearer token, your tenant ID (tid) and subscription key on every call | Authentication |
| Requests | JSON bodies. PATCH takes a JSON Patch document | Request Methods |
| Responses | Standard HTTP status codes, with JSON error bodies | Response Codes |
| Paging | page_size and a ContinuationToken header | Pagination |
| Limits | A rate limit per application and a quota per tenant | Rate Limiting & Quotas |
| Access | Access profiles control which operations, security groups control which assets | Roles and Security Groups |
| Dates and times | ISO 8601 in UTC | Date and Time Format |
| Networking | HTTPS on port 443, allow by hostname | IP Addresses & Whitelisting |
| Object IDs | Readable IDs with a tenant prefix, such as in-000123 | Object IDs |
TLS 1.2 or laterPerspioTalk only accepts HTTPS connections using TLS 1.2 or 1.3. Make sure your HTTP client supports TLS 1.2 as a minimum.