On this page

usage-downloads

Get usage-downloads

Get usage data files with temporary download links for valid licenses. Supports pagination via query parameters.

This endpoint is part of Cloud-specific endpoints.

GET /api/v2/usage-downloads

Parameters

ParameterTypeExampleDescription
Authorization (required)headerJWT from Qt Login for an authenticated user as bearer token
pagequeryPage number for pagination (default: 1)
limitqueryNumber of items per page (default: 50, max: 100)

Responses

CodeDescription
200Successfully retrieved usage data files with download links. Returns paginated format when page/limit parameters are provided, otherwise returns array format for backward compatibility.
400Bad request
401Unauthorized/Invalid JWT error

Example responses

{
  "licenseId": "12345678",
  "files": [
    {
      "name": "usage-report-2024-03-20.json",
      "downloadUrl": "https://bucket-name.s3.region.amazonaws.com/licenses/12345678/usage-report-2024-03-20.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&..."
    }
  ]
}

or

{
  "data": [
    {
      "licenseId": "12345678",
      "files": [
        {
          "name": "usage-report-2024-03-20.json",
          "downloadUrl": "https://bucket-name.s3.region.amazonaws.com/licenses/12345678/usage-report-2024-03-20.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&..."
        }
      ]
    }
  ],
  "pagination": {
    "page": 2,
    "limit": 50,
    "total": 150,
    "totalPages": 3
  }
}
{
  "status": false,
  "message": "Invalid request parameters"
}
{
  "status": false,
  "code": "1234"
}

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.