Continuata • Downloader

Base URL

All API requests should be made to:

https://continuata.io/api

Authentication Methods

API Keys (Recommended)

API keys provide secure, token-based authentication for server-to-server integrations.

Getting Your API Key

Go to your Continuata dashboard
Navigate to Settings → API Keys
Click "Generate New API Key"
Give it a descriptive name (e.g., "Shopify Integration")
Set appropriate permissions
Copy and store the key securely

Security Notice

API keys are only shown once. Store them securely and never expose them in client-side code.

Using API Keys

Include your API key in the Authorization header:

Authorization: Bearer ct_your_api_key_here

Example Request

curl -X GET "https://continuata.io/api/products" \
  -H "Authorization: Bearer ct_your_api_key_here" \
  -H "Content-Type: application/json"

API Key Permissions

When creating API keys, you can limit their scope with granular permissions:

Read Permissions

• products:read - List and view products
• downloads:read - View download tokens
• analytics:read - Access usage stats

Write Permissions

• products:write - Create/update products
• downloads:write - Generate tokens
• uploads:write - Upload product files

Response Format

All API responses use JSON format and include consistent structure:

Success Response

{
  "success": true,
  "data": {
    // Response payload
  },
  "meta": {
    "timestamp": "2025-01-01T00:00:00Z",
    "requestId": "req_1234567890"
  }
}

Error Response

{
  "success": false,
  "error": {
    "code": "INVALID_TOKEN",
    "message": "The provided API key is invalid or expired",
    "details": {}
  },
  "meta": {
    "timestamp": "2025-01-01T00:00:00Z",
    "requestId": "req_1234567890"
  }
}

Common Error Codes

401 UNAUTHORIZEDMissing or invalid API key

403 FORBIDDENAPI key lacks required permissions

429 RATE_LIMITEDToo many requests, see rate limiting

500 INTERNAL_ERRORServer error, contact support

Rate Limiting

API requests are rate limited to ensure service stability:

Free Plan: 100 requests per hour
Pro Plan: 1,000 requests per hour
Enterprise: 10,000 requests per hour

Rate Limit Headers

All responses include rate limit information:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200

SDK and Libraries

Official SDKs are available for popular programming languages:

JavaScript/Node.js

npm install @continuata/sdk

Python

pip install continuata-python

Ruby

gem install continuata

PHP

composer require continuata/sdk

Testing Your Integration

Test your API integration with this simple endpoint:

curl -X GET "https://continuata.io/api/user" \
  -H "Authorization: Bearer ct_your_api_key_here"

Expected response:

{
  "success": true,
  "data": {
    "user": {
      "id": "user_1234567890",
      "name": "John Doe",
      "email": "john@example.com",
      "org": {
        "id": "my-audio-company",
        "name": "My Audio Company"
      }
    }
  }
}

Next Steps

Now that you understand authentication, explore theProducts API to start managing your digital products programmatically.

API Authentication