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

开发中

POST

/files/{fileId}/url

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

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

说明

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

请求参数

Path 参数

fileId

string

必需

Header 参数

X-Shimo-Signature

string

必需

石墨根据 AppId、AppSecret 以及 fileId 签名出的 Signature 字符串，用于接入方校验请求来源合法性

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

🟢200成功

application/json

Body

url

string

必需

示例

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

修改于 2025-06-30 09:26:19