Connect download service#

Service for downloading Connect binaries

OpenAPI file: nominal.connect.download.v1.json

Endpoints#

Get latest connect uri#

GET /connect/v1/download/{platform}/uri

Get a pre-signed URL for downloading the latest version of Connect for a given platform Scoped to the caller’s org, which picks the release channel. Any session may call it.

Path parameters

platform string, one of macos, macos-pkg, windows, ubuntu required

One of macos, macos-pkg, windows, ubuntu.

Response

uri string

​

Request

curl "https://api.gov.nominal.io/api/connect/v1/download/<platform>/uri" \
  -H "Authorization: Bearer <api key>"

import requests

response = requests.get(
    "https://api.gov.nominal.io/api/connect/v1/download/<platform>/uri",
    headers={"Authorization": "Bearer <api key>"},
)
response.raise_for_status()
print(response.json())

import httpx

response = httpx.get(
    "https://api.gov.nominal.io/api/connect/v1/download/<platform>/uri",
    headers={"Authorization": "Bearer <api key>"},
)
response.raise_for_status()
print(response.json())

import asyncio

import aiohttp


async def main() -> None:
    async with aiohttp.ClientSession() as session:
        async with session.get(
            "https://api.gov.nominal.io/api/connect/v1/download/<platform>/uri",
            headers={"Authorization": "Bearer <api key>"},
        ) as response:
            response.raise_for_status()
            print(await response.json())


asyncio.run(main())

Response: 200

{
  "uri": "<uri>"
}

Get latest version#

GET /connect/v1/download/{platform}/version

Get the latest version string of Connect for a given platform Scoped to the caller’s org, which picks the release channel. Any session may call it.

Path parameters

platform string, one of macos, macos-pkg, windows, ubuntu required

One of macos, macos-pkg, windows, ubuntu.

Response

version string

​

Request

curl "https://api.gov.nominal.io/api/connect/v1/download/<platform>/version" \
  -H "Authorization: Bearer <api key>"

import requests

response = requests.get(
    "https://api.gov.nominal.io/api/connect/v1/download/<platform>/version",
    headers={"Authorization": "Bearer <api key>"},
)
response.raise_for_status()
print(response.json())

import httpx

response = httpx.get(
    "https://api.gov.nominal.io/api/connect/v1/download/<platform>/version",
    headers={"Authorization": "Bearer <api key>"},
)
response.raise_for_status()
print(response.json())

import asyncio

import aiohttp


async def main() -> None:
    async with aiohttp.ClientSession() as session:
        async with session.get(
            "https://api.gov.nominal.io/api/connect/v1/download/<platform>/version",
            headers={"Authorization": "Bearer <api key>"},
        ) as response:
            response.raise_for_status()
            print(await response.json())


asyncio.run(main())

Response: 200

{
  "version": "<version>"
}

Errors#

Errors shows how these errors are sent.

Each error’s errorName is NominalConnectDownloadV1: followed by its name below.

Status

Name

Notes

404

ConnectDownloadServiceErrorConnectNotAvailable

Connect not available for download on this stack. Please contact support.

Page design based on Scalar, MIT License.