获取接入方指定文件的完整访问地址
开发中POST
{endpoint_url}/files/{fileId}/url通过接入方文件 ID 获取接入方完整的访问地址,此接口通常为协同文档场景下使用。
如轻文档文件中存在 @ 其他文件的关联,此文件导出为 docx 时,文件中的 @ 关联会转换为石墨 SDK 的跳转链接,当访问此跳转链接时,石墨 SDK 会尝试通过 fileId
获取接入方系统的完整访问地址进行重定向。
:::caution 说明
接口由石墨 SDK 主动发起,出于安全考虑,建议对此接口传递的 HTTP Header X-Shimo-Signature
进行校验,签名算法与接入方生成签名的方法一致。
:::
请求参数
Path 参数
endpoint_url
string
必需
示例值:
{{ endpoint_url}}
fileId
string
必需
Header 参数
X-Shimo-Signature
string
必需
石墨根据 AppId、AppSecret 以及 fileId 签名出的 Signature 字符串,用于接入方校验请求来源合法性
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
url
string
必需
示例
{
"url": "https://your-server-domain/path/to/url"
}
最后修改时间: 1 年前