Introduction

Authentication

Using the API key you generated you can use it to authenticate with the API.


Authentication method

The API key you use to authenticate should be kept a secret and only be used on a server side not via the client. Exposing this key could cause bad things to happen.

Authentication method used is Bearer token.

Add the token in your request header

Authentication: Bearer <token>

JavaScript example

import axios from 'axios';
axios.defaults.baseURL = 'https://app.digital-downloads.com/api/v1/';
axios.defaults.headers.common = { 'Authorization': 'Bearer Xmwm2j3EPqQOY51F1QfU6aqFHDQsB1nSTGxxII1a3c5MSYULoVBbHKZ1UL3yxntBETADT' };


// example usage
let orders = await axios.get('/orders');

Request headers

This is a JSON API, make sure you set these headers.

Accept: application/json
Content-Type: application/json

Rate limits - Error code 429

60 requests per minute.

Rate limit headers will be returned on each request. E.g.

X-RateLimit-Limit: 15
X-RateLimit-Remaining: 14

If you require a higher rate limit, then please contact us.


Error responses

401 - Unauthorized

Your API key is not valid. The key is incorrect or has been revoked.

402 - Upgrade required

Storage limit has been reached, upgrade your plan for more space.

404 - Not found

The resource you are trying to access can not be found.

422 - Validation error

Validation error.

Example response when creating a URL asset

{
    "message": "The filename is required. (and 3 more errors)",
    "errors": {
        "filename": [
            "The filename field is required.",
            "The filename name must be a string.",
            "The filename must be not be more than 255 characters."
        ],
        "size": [
            "The size field is required."
        ],
        "url": [
            "The url field is required."
        ]
    }
}

500 - Server error

All server errors will be directly reported to us automatically. If the problem persists please contact us.

Previous
Getting started