获取文件下载地址

所需 OAuth scope：release:read

返回包含下载 URL 的 JSON，客户端再请求 data.url 下载文件。成功响应带 Cache-Control: no-store。

必须明确指定 source（direct 或下载源 ID 字符串），且该源必须对软件启用并具有当前文件的可用副本；不可用时返回 409，不自动回退。

指定 asset_id 时直接选择文件，可省略平台和 version；若同时传入 version/os/arch，必须与文件匹配。

未指定 asset_id 时，version 为空或 latest 表示配置的最新版本，其他值按版本 tag 精确匹配。优先使用显式 os/arch，缺失部分从 Client Hints 和 User-Agent 推断；仍缺失则返回 422 platform_required。平台匹配包含 any 通用文件；无匹配返回 404，多文件匹配返回 422 asset_ambiguous。

S3 返回临时签名 URL 及 expires_at；direct 和 GitHub 镜像返回地址且 expires_at 为 null。仅提供已启用且上游可用的版本；GitHub 模式未开启 include_prerelease 时隐藏预发布版本。

鉴权：Authorization: Bearer ，支持用户 JWT 和 OAuth2 Access Token。OAuth2 需要 release:read，release:* 或 all 也可授权。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

获取成功

Headers

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "获取成功",
    "data": {
        "release_id": 1,
        "version_id": 1,
        "tag": "string",
        "asset_id": 1,
        "filename": "string",
        "os": "string",
        "arch": "string",
        "size": 0,
        "checksum": "string",
        "source": "string",
        "url": "http://example.com",
        "expires_at": "2019-08-24T14:15:22.123Z"
    }
}

🟠400错误 400

🟠401错误 401

🟠403错误 403

🟠404错误 404

🟠409错误 409

🟠422错误 422

🔴500错误 500

🔴502错误 502

🔴503错误 503

获取文件下载地址

请求参数

请求示例代码

返回响应