Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt

Introduction

This documentation

...

is provided as a reference where the use of an open source OAuth2 client library for authentication is not available.

AgDataShop products accessible via API require a Json Web Token (JWT) as a bearer access token to authenticate every API request.  You need to get a bearer token and then use it in the Authorization header of each API request to use the API to access the product data successfully.  It is used by the API endpoint to confirm you have access to the product before providing product data. Most programming languages will have libraries with support for OAuth2 which can automate this process, but it is explained in detail on this page for reference and to help debug and test product API calls using interactive API-docs.

Note

This documentation only applies to products where the shop has provided you a client_id and a client_secret in order to obtain access to to the product via an API. Downloadable products do not require API access or the use of these credentials.

Retrieving an access token

...