批量获取预签名链接

本接口用于把手中的 TOS 媒体链接批量换成当前可访问的预签名链接。适用于一切 TOS 链接,不限于消息——素材 imageUrl、朋友圈媒体、头像、消息图片/文件链接均可,接口只按域名识别、不区分来源。仅对开启 TOS 私有化签名的环境有意义。

对象存储私有化后,媒体裸链不可直接访问。系统下发(API 响应 / 回调推送)时会自动携带预签名链接,有效期见响应的 expiresIn。典型场景:

按文档要求存库的是裸链(或入参原链接),需要访问时换签;

此前拿到的预签名链接已过期或将过期,重新换签(续期,重复调用幂等,有效期重新计时);

混合来源的一批链接统一处理:非本系统存储域名的链接原样返回,可安全传入任意 URL。

返回数据说明:

items 与入参 urls 等长同序;items[].url 为入参原链接(原样回显,可用于精确匹配);

presignedUrl == url 表示该条未签名,共三种情况:① 链接域名不属于本系统对象存储;② 链接对象不属于当前企业,拒绝换签;③ 服务端签名开关关闭(此时 expiresIn=0);

业务参数(如 x-tos-process)与 #锚点原样保留;

请勿把 presignedUrl 持久化入库——入库请存裸链,按 expiresIn 规划刷新(建议 80% 时效处换签)。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "items": [
            {
                "url": "https://my-bucket.tos-cn-beijing.volces.com/mh/permanent/material/671f.../image.png",
                "presignedUrl": "https://my-bucket.tos-cn-beijing.volces.com/mh/permanent/material/671f.../image.png?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=...&X-Tos-Date=20260708T105534Z&X-Tos-Expires=86400&X-Tos-Signature=...&X-Tos-SignedHeaders=host"
            },
            {
                "url": "https://wework.qpic.cn/wwpic/xxx/0",
                "presignedUrl": "https://wework.qpic.cn/wwpic/xxx/0"
            }
        ],
        "expiresIn": 86400
    }
}

请求参数

请求示例代码

返回响应