Open API 3.0

Definition files

These OpenAPI documents describe the Pryv.io API and conform to the OpenAPI Specification. They are represented in YAML format and can be downloaded from the following links to be imported on other API tools such as Postman.

Usage

Postman

Import

The OpenAPI description of Open-Pryv.io or Pryv.io Entreprise can be directly imported into Postman to test the API’s functionality.

Import on Postman

You can choose to upload a file, enter a URL, or copy the YAML file on Postman.

Import the open-api-format/api.yaml from the URL link or the YAML file directly with Import as an API and Generate a Postman Collection checked. If you are using the Open Source version of Pryv.io, import the open-api-format/api_open.yaml from the URL link.

Environment

Add the Environment

Fill in the variable baseUrl as shown below:

Manage the Environment

The variable baseUrl should be set as https://{{token}}@{{username}}.pryv.me, with the variables username and token corresponding to the username and access token of your Pryv account. You can find more information on how to create a Pryv user on the dedicated page, and obtain an Access Token from the Pryv Access Token Generator.

In our example, the username “testuser” associated to the token “cdtasdjhashdsa” are used to set the baseUrl variable as https://cdtasdjhashdsa@testuser.pryv.me.

Note that you should remove trailing slash for the variable baseUrl to have a working environment.

Finally, click on Add to update the environment.

Testing the API

Open API methods

Select a method by directly clicking on it.

For GET methods, you can check or uncheck the Query Params you need, and fill them with the right value in the Params field.

As an example, see the method events.get below :

events.get

For POST and PUT methods, you should fill the necessary parameters in the Body field.

As an example, the different parameters name, parentId, etc. should be completed with their own value when creating a new stream for the method streams.create below :

events.get

Send request

The original API reference can be found online.

For any questions or suggestions, do not hesitate to contact our team directly.