Marketron Data Rest API (V1)

Download OpenAPI specification:Download

Introduction

Marketron’s Data API allows developers to access their companies data from Marketron’s data warehouse. Allowing companies to keep data synced and up to date across their ecosystem, eliminating data inconsistencies from legacy data sharing processes.

GraphQL

Interested in consuming the Data API via GraphQL? Please visit Marketron's Data API GraphQL documentation and playground at https://api.marketronnxt.com/graphql

Versioning

The API version is denoted in the URI. This API's base URI is: https://api.marketronnxt.com/data/V1

Setup

To access Marketron’s Data API you will need to contact support@marketron.com in order to request access and receive an API key with credentials.

Authentication

Authenticating with the Marketron Data API requires both a username / password and an API Key that will be provided to you.

In order to call any of the REST or GraphQL end points, you must first retrieve an Authentication Token. This is done by making a GET request to /login. Your request must contain the following items.

bearerAuth

Security Scheme Type HTTP
HTTP Authorization Scheme bearer
Bearer format "JWT"

apiKey

Security Scheme Type API Key
Header parameter name: X-API-Key

Body {

"username": "<your username>",
"password": "<your password>"

}

Header {

"x-api-key": "<your provided key>",
"content-type": "application/json",
"x-request-id": "<generated request id>"

}

The generated request id is a unique ID that should be generated for each new API call. This is used by Marketron to keep track of each call. The format for the ID should be UUID V4 e.g. 11bf5b37-e0b8-42e0-8dcf-dc8c4aefc000

You should get a response containing your Authentication Token. This token is should be in all your future request headers.