本文档由石墨办公提供。

获取接入方指定文件的完整访问地址

POST

/files/{fileId}/url

通过接入方文件 ID 获取接入方完整的访问地址，此接口通常为协同文档场景下使用。

如轻文档文件中存在 @ 其他文件的关联，此文件导出为 docx 时，文件中的 @ 关联会转换为石墨 SDK 的跳转链接，当访问此跳转链接时，石墨 SDK 会尝试通过 fileId 获取接入方系统的完整访问地址进行重定向。

说明

接口由石墨 SDK 主动发起，出于安全考虑，建议对此接口传递的 HTTP Header X-Shimo-Signature 进行校验，签名算法与接入方生成签名的方法一致。

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
    "fileId": "string"
}

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/files//url' \
--header 'X-Shimo-Signature;' \
--header 'Content-Type: application/json' \
--data '{
    "fileId": "string"
}'

🟢200成功

application/json

Bodyapplication/json

示例

{
    "url": "https://your-server-domain/path/to/url"
}

修改于 2026-08-31 04:37:16