Skip to content

Quick Start

Get up and running with BinDist in just a few minutes.

Prerequisites

  • A BinDist account with an API key
  • curl or any HTTP client

Step 1: Get Your API Key

After signing up, you'll receive an API key. This key is used to authenticate all API requests.

Keep Your API Key Secure

Your API key provides access to your applications. Never share it or commit it to version control.

Step 2: List Your Applications

Make your first API call to list all applications you have access to:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.bindist.eu/v1/applications

const response = await fetch('https://api.bindist.eu/v1/applications', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});
const data = await response.json();
console.log(data);

$headers = @{
  "Authorization" = "Bearer YOUR_API_KEY"
}
Invoke-RestMethod -Uri "https://api.bindist.eu/v1/applications" -Headers $headers

Example Response:

{
  "success": true,
  "data": {
    "applications": [
      {
        "applicationId": "my-app",
        "name": "My Application",
        "description": "A sample application",
        "isActive": true
      }
    ],
    "pagination": {
      "hasMore": false,
      "nextCursor": null
    }
  }
}

Step 3: Get a Download URL

Once you know which application and version you want, request a download URL:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.bindist.eu/v1/downloads/url?applicationId=my-app&version=1.2.0"

const response = await fetch(
  'https://api.bindist.eu/v1/downloads/url?applicationId=my-app&version=1.2.0',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);
const data = await response.json();
console.log(data.data.downloadUrl);

Example Response:

{
  "success": true,
  "data": {
    "downloadUrl": "https://s3.amazonaws.com/...",
    "expiresAt": "2025-01-15T12:30:00Z",
    "fileName": "my-app-1.2.0.exe",
    "fileSize": 15728640,
    "checksum": "sha256:abc123..."
  }
}

Step 4: Download the File

Use the pre-signed URL to download the file. The URL expires after 30 minutes.

curl -L -o my-app-1.2.0.exe "DOWNLOAD_URL_FROM_PREVIOUS_STEP"

Next Steps