通过文件夹id获取该文件夹下的文件链接

POST

/sts/folder/share_links

通过文件夹id获取该文件夹下的文件链接。

通过官网->素材库新建文件夹。并获取该文件夹的唯一id:

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200

application/json

成功

Bodyapplication/json

🟠400

🟠401

🟠404

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://open.vectcut.com/sts/folder/share_links' \
--header 'Authorization: Bearer  <token>' \
--header 'Content-Type: application/json' \
--data '{
    "folder_id": "3d999621d7c14d59ba9aeb38ea1adc1f",
    "limit": 100
}'

响应示例

200 - folder_with_files

{
    "success": true,
    "folder_id": "3a4d1b7d-f9ef-4c1f-95c8-597d08a5df21",
    "folder_path": "项目A/成片",
    "include_subfolders": true,
    "items": [
        {
            "object_key": "files/user_123/20260603/demo.mp4",
            "file_name": "demo.mp4",
            "folder_path": "项目A/成片",
            "file_size_bytes": 12873455,
            "updated_at": "2026-06-03 15:23:10",
            "public_signed_url": "https://example.com/demo.mp4?OSSAccessKeyId=xxx&Expires=xxx&Signature=xxx"
        }
    ],
    "count": 1
}

修改于 2026-06-03 09:20:31

如何使用素材库

create_draft