[OMS:FILE:DOCUMENT:WRITE] 签发对外免登下载链接

测试环境

http://test-cn.your-api-server.com

POST

/api/v1/oms/files/{document_id}/public-link

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Body 参数application/json必填

示例

{
    "days": 1,
    "purpose": "download"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://test-cn.your-api-server.com/api/v1/oms/files//public-link' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "days": 1,
    "purpose": "download"
}'

返回响应

🟢200

application/json

Successful Response

Bodyapplication/json

示例

{
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "code": "W200",
    "msg": "成功",
    "errors": [],
    "data": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "document_id": "b792e8ae-2cb4-4209-85b9-32be4c2fcdd6",
        "url": "string",
        "expires_in": 0,
        "purpose": "string"
    }
}

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠409Conflict

🟠413PayloadTooLarge

🟠422UnprocessableEntity

🟠429TooManyRequests

🔴500InternalError

修改于 2026-08-31 17:36:55

[OMS:FILE:DOCUMENT:READ] 按文档 ID 取短时下载地址

[OMS:FILE:DOCUMENT:READ] 列出文档的公网下载授权