Skip to main content

Prerequisites

Introduction

This getting started guide will walk you through the basic operations you can take to interact with the Sales Channel Services API. Before you can start using the API, you need access to the service. The needed actions depend on if you already have an active Puro.earth account in use. Please read instructions above for more information about how to get access and authenticate to Sales Channel Services API.

More detailed instructions for the concepts of this API can be found in Concepts. You can also refer to the OpenAPI endpoint specification to get more information about the API endpoints.

Getting Access to Sales Channel Services

Contact Puro.Earth to get your Sales Channel onboarded to Sales Channel Services. Once the agreement is signed, an Azure B2C account for the Sales Channel will be created by us.
The created account can be used to generate and manage long-lived API keys to be used for machine-to-machine cpurposes.

Authenticating

There are two options to authenticate against Sales Channel Services API:

  1. Access token: Obtain and authenticate with a short-living access token as described in Obtaining an access token section.
  2. API key: Obtain and authenticate with a long-living API key as described in Obtaining an API key section.