🚀 Welcome to MDriven Learn –  MDriven is now on Discord!  Don’t miss the latest Release Notes.
REST API For MDriven Versioned Downloads
This page was created by Charles on 2025-07-15. Last edited by Wikiadmin on 2026-07-29.

You can use this REST endpoint to retrieve versioned download information for MDriven Turnkey, MDriven Server, and the MDriven Framework Visual Studio extension when you need to automate or script product downloads.

Endpoint

Send an HTTP GET request to:

https://mdriven.net/Rest/ProductRelease/Get

The endpoint identifies a product release through query parameters. Use HTTPS and URL-encode parameter values when your HTTP client does not do this automatically.

Choose a product

Set vProduct to the product file family you want.

vProduct value Product file family
Framework MDriven Framework Visual Studio extension
TurnkeyCore MDriven Turnkey for .NET Core
TurnkeyFramework MDriven Turnkey for .NET Framework
ServerCore MDriven Server for .NET Core
ServerFramework MDriven Server for .NET Framework

For example, this request selects the MDriven Turnkey .NET Core product family:

https://mdriven.net/Rest/ProductRelease/Get?vProduct=TurnkeyCore

Refine the release with platform and version

Add platform to select a platform-specific product file. Add version to request a build by its build date.

Parameter Purpose Accepted values documented for this endpoint Example
vProduct Selects the product file family. Framework, TurnkeyCore, ServerCore, TurnkeyFramework, ServerFramework vProduct=ServerCore
platform Selects the platform variant. windows, linux, macos, alpine, linux musl, linux arm64, Osx X64, Osx Arm64 platform=linux
version Selects a build by build date, in yyyymmdd format. An eight-digit build date version=20250710

Platform value encoding

Values that contain spaces must be URL-encoded in the request URL. For example:

platform=linux%20musl

Use the platform spelling and capitalization shown in the table when calling the endpoint. The public downloads page shows the platform variants currently offered for MDriven Turnkey and MDriven Server, including Windows, Linux, Linux Arm64, Linux MUSL, Osx X64, and Osx Arm64.

Version format

A version is a build date, not a semantic version number. For 10 July 2025, use:

20250710

Do not use separators such as 2025-07-10.

Request examples

Select a product family

Request MDriven Turnkey .NET Core release information:

GET https://mdriven.net/Rest/ProductRelease/Get?vProduct=TurnkeyCore

Select a Windows variant

Request MDriven Turnkey .NET Core release information for Windows:

GET https://mdriven.net/Rest/ProductRelease/Get?vProduct=TurnkeyCore&platform=windows

Select a dated Linux build

Request the Linux build dated 10 July 2025:

GET https://mdriven.net/Rest/ProductRelease/Get?vProduct=TurnkeyCore&platform=linux&version=20250710

Call the endpoint from a command line

This curl example requests the same dated Linux build. Quote the URL so that your shell does not interpret & as a command separator.

curl "https://mdriven.net/Rest/ProductRelease/Get?vProduct=TurnkeyCore&platform=linux&version=20250710"

Use the result in an automated download flow

The endpoint returns a JSON result. A typical automation flow is:

  1. Choose the product family with vProduct. For example, use ServerCore for a .NET Core MDriven Server deployment.
  2. Add the target platform. For example, use linux arm64, encoded as linux%20arm64, for a Linux Arm64 target.
  3. Add version when your deployment must retrieve a specific dated build; omit it when your process is intended to use the endpoint's product selection without a specified date.
  4. Send the GET request and parse the JSON response in your deployment script.
  5. Use the download information returned by the response in the next download step.

Keep the product, platform, and build date as explicit configuration values in a repeatable deployment. For example, a release pipeline can set vProduct=ServerCore, platform=linux, and version=20250710 so that every environment retrieves the same dated build.

Scope

This is an MDriven product-release endpoint. It is not the mechanism for exposing a REST API from your own MDriven application or for consuming an external REST service. To download a file from a ViewModel action, see RestDownload.

For interactive downloads and the available current releases, use the downloads page.

See also