MeBox/115doc/115开放平台/API列表/文件管理/文件上传/获取上传凭证.md

获取上传凭证

基本信息

属性	内容
接口名称	获取上传凭证
接口版本	v1.0
接口路径	/upload/get_token
请求方法	GET
接口状态	生产环境

接口说明

获取对象存储上传域名和临时上传凭证。

接口地址

https://proapi.115.com/open/upload/get_token

请求方式

GET

认证方式

Authorization: Bearer access_token

请求参数

无

请求示例

curl 'https://proapi.115.com/open/upload/get_token' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

响应字段说明

字段	类型	描述
state	boolean	状态码，是表示成功，否表示异常
message	string	异常信息
code	int	异常码
data	object	上传凭证数据
data.endpoint	string	上传域名
data.AccessKeySecret	string	临时上传凭证密钥
data.SecurityToken	string	临时安全令牌
data.Expiration	string	上传凭证过期时间
data.AccessKeyId	string	临时上传凭证 ID

响应示例

{
  "state": true,
  "message": "",
  "code": 0,
  "data": {
    "endpoint": "",
    "AccessKeySecret": "",
    "SecurityToken": "",
    "Expiration": "",
    "AccessKeyId": ""
  }
}

注意事项

• 网页版文档中的密钥字段名存在拼写误差，服务端实际返回字段为 AccessKeySecret。
• 上传凭证为敏感信息，仅用于当前上传流程；不要写入日志、持久化存储或对外暴露。
• 服务端通过当前 access_token 识别用户，不接收用户账号请求参数。

修改历史

修改时间	修改说明
2025年04月01日(周二) 00:00:00	创建文档