Standard: RESTful

PerspioTalk is a Restful API that uses HTTP requests to GET, PUT, POST, and DELETE data following the REST architectural style. Our REST API is built around simple-to-understand resource-oriented URLs that can be accessed by any HTTP client - or any programming language that supports an HTTP library.

All endpoints are publically available and hosted on https://talk.perpsio.io.

Developer Hub API Reference: All endpoints documented within this API reference, including the ability to auto-generate code snippets to jumpstart integrations and shareable links for every API request, make it easy to debug issues or get support.

Postman Collections: Several postman collections have been compiled with several commonly used endpoints to allow you to get started quickly in postman, a popular tool amongst our developer community.

OpenAPI Spec: We also provide developers with exports of our API collections in the OpenAPI format. This can be used to import into many popular toolsets, middleware and 3rd party clients.

These three references should provide anyone with all of the technical information required to make successful HTTP connections to any PerspioTalk endpoint.

Authentication: OAuth2.0

PerspioTalk uses OAuth2.0 as its authorisation framework. The authorisation process ultimately generates an access_token required to make successful calls to any PerspioTalk resource. This is treated as a Bearer Token.

You will need to obtain your token using one of the following flows:

1. Client Credentials
2. Authorisation Code

Jump over to Authentication for information and instructions on how to complete each flow.

Once you've obtained your token, it is provided in the Authorization request header, along with any other request header parameters.