调用方式
文件管理 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 参数:
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 秒重新申请,详见请求鉴权。