Skip to main content

OpenAPI

We publish OpenAPI 3-compliant spec files for the MyPuro API. These specification files describe the API interface we expose in a machine-readable format. This includes information like the available authentication mechanisms, a list of the endpoints we expose, the arguments those endpoints expect and the shape of the possible responses.

Types of Specs​

We publish two types of specification files:

  • Generic specification files, which are environment-agnostic.
  • Environment-specific specification files, which come baked-in with environment specific configuration.

Generic​

You will find a generic OpenAPI specification file for the latest version of the API as part of this documentation website. It can be viewed and downloaded from the OpenAPI Spec page.

This specification will have placeholders for certain environment specific values.

info

These specification files are primarily presented for showing humans the API interface we expose. If you need a populated version of the spec, then obtain an Environment Specific specification file, which will not include any placeholders.

Environment-Specific​

At runtime, the application can provision a fully populated OpenAPI spec. It will be hosted in JSON format under mypuro/api-json of the hostname of each environment.

Example

For the production server endpoint you can find the OpenAPI spec at https://mypuro.api.puro.earth/mypuro/api-json.

OpenAPI UI​

You can also consume the environment-specific OpenAPI specs through the OpenAPI UI. It will be published at mypuro/api of the hostname of each environment.

The OpenAPI UI lets you interact with the API in a fully pre-configured environment.

Example

For the production server endpoint you can find the OpenAPI UI at https://mypuro.api.puro.earth/mypuro/api.