Applications API¶

Endpoints for listing and retrieving application information.

List Applications¶

List all applications accessible to the authenticated user.

GET /v1/applications

Query Parameters¶

Parameter	Type	Description
`search`	string	Search by name or description
`tag`	string	Filter by tag
`limit`	number	Maximum items (default: 50, max: 100)
`cursor`	string	Pagination cursor

Example Request¶

curlJavaScript

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

import { createBinDistClient } from '@bindist/client';

const client = createBinDistClient({
  baseUrl: 'https://api.bindist.eu',
  apiKey: 'YOUR_API_KEY'
});

const result = await client.listApplications({ limit: 10 });
console.log(result.data.applications);

Example Response¶

{
  "success": true,
  "data": {
    "applications": [
      {
        "applicationId": "my-app",
        "name": "My Application",
        "description": "A sample application for demonstration",
        "isActive": true,
        "tags": ["windows", "utility"],
        "createdAt": "2024-06-15T10:30:00Z",
        "updatedAt": "2025-01-10T14:22:00Z"
      }
    ],
    "pagination": {
      "hasMore": false,
      "nextCursor": null
    }
  }
}

Get Application¶

Get details for a specific application.

GET /v1/applications/{applicationId}

Path Parameters¶

Parameter	Type	Description
`applicationId`	string	The application ID

Example Request¶

curlJavaScript

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

const result = await client.getApplication('my-app');
console.log(result.data);

Example Response¶

{
  "success": true,
  "data": {
    "applicationId": "my-app",
    "name": "My Application",
    "description": "A sample application for demonstration",
    "isActive": true,
    "tags": ["windows", "utility"],
    "createdAt": "2024-06-15T10:30:00Z",
    "updatedAt": "2025-01-10T14:22:00Z",
    "versionCount": 5
  }
}

Error Responses¶

Application Not Found (404)

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Application not found"
  }
}

Get Statistics¶

Get download statistics for an application.

GET /v1/applications/{applicationId}/stats

Path Parameters¶

Parameter	Type	Description
`applicationId`	string	The application ID

Query Parameters¶

Parameter	Type	Description
`version`	string	Filter by specific version

Example Request¶

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

Example Response¶

{
  "success": true,
  "data": {
    "applicationId": "my-app",
    "totalDownloads": 1523,
    "downloadsByVersion": {
      "2.1.0": 450,
      "2.0.0": 823,
      "1.5.0": 250
    },
    "downloadsByDay": [
      { "date": "2025-01-10", "count": 45 },
      { "date": "2025-01-09", "count": 52 },
      { "date": "2025-01-08", "count": 38 }
    ]
  }
}