文件管理调用方式

调用方式

文件管理 API 通过 HTTPS 协议调用,响应数据格式统一为 JSON。

基础信息

接口前缀
/
协议
HTTPS(不支持 HTTP)
响应格式
JSON(Content-Type: application/json)
字符编码
UTF-8

环境域名

环境域名说明
测试环境https://file.test.sign.tencent.com用于开发和测试
正式环境https://sgfile.tencent-esign.com生产环境

完整请求地址,例如:

POST https://sgfile.tencent-esign.com/

Header 设置

所有文件管理接口请求须携带以下 Header 参数:

Authorization必填string
鉴权 Token,格式:Bearer <access_token>。access_token 通过 OAuth 2.0 授权获取,详见请求鉴权。
X-TC-Action必填string
接口名称,每个接口的固定值不同,以各接口文档为准。例如上传文件接口为 `CreateUploadFile`。
X-TC-Timestamp必填string
当前 UNIX 时间戳(秒),例如 `1605024000`。用于请求时效性校验,与服务器时间偏差不得超过 5 分钟。
X-TC-Language选填string
响应语言,支持 `zh-CN`(简体中文,默认)/ `en-US`(英文)。
ℹ️

Authorization 中的 access_token 有效期为 1 小时,建议在到期前约 60 秒重新申请,详见请求鉴权