文档中心 > API类目 > 多媒体平台API

taobao.picture.token (获取文件上传token)

获取图片上传token,作为http://upload.cloud.tmall.com/api/proxy/upload接口上传的凭证。 上传的html示例代码为: <form action="http://upload.cloud.tmall.com/api/proxy/upload" method="post" enctype="multipart/form-data"> 上传token: <input type="text" name="Authorization" value="" /><br/> 上传文件:<input type="file" name="content" /><br/> <input type="submit" value="Submit "/> </form>

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
generate_token_request GenerateTokenRequest 必须 请求参数
  • upload_policy
  • UploadPolicy
  • 可选
  • 请求策略
  • └ size_limit
  • Number
  • 可选
  • 100
  • 限制用户上传文件的大小。 若用户上传文件大小超过size_limit,无法上传成功。
  • └ mime_limit
  • String
  • 可选
  • image/jpeg
  • 限制用户上传文件的类型,多个值用;分隔。 可设置的值为:image/jpeg,image/png,image/webp等。 若用户上传文件的mime类型不在mime_limit范围内,无法上传成功。
  • └ dir_id
  • Number
  • 可选
  • 123
  • 图片分类ID,可通过taobao.picture.category.get获取。根目录值为0。
  • └ expired_time
  • Number
  • 可选
  • 1581492546956
  • token有效期的截止时间,值为自1970年1月1日0时起的毫秒数。若当前时间晚于expired_time,token失效,上传文件失败。

响应参数

名称 类型 示例值 描述
result UsResultDto 响应dto
  • └ code
  • Number
  • 200
  • 返回码
  • data
  • GenerateTokenResponse
  • 响应response
  • └ token
  • String
  • ZXlKaGNIQkxaWGtpT2lJeElpd2lkWEJzYjJGa1VHOXNhV041SWpwN0ltSnBl
  • 返回的token
  • └ success
  • Boolean
  • true
  • 响应结果
  • └ error_msg
  • String
  • 返回成功
  • 响应结果说明

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
PictureTokenRequest req = new PictureTokenRequest();
PictureTokenRequest.GenerateTokenRequest obj1 = new PictureTokenRequest.GenerateTokenRequest();
PictureTokenRequest.UploadPolicy obj2 = new PictureTokenRequest.UploadPolicy();
obj2.setSizeLimit(100L);
obj2.setMimeLimit("image/jpeg");
obj2.setDirId(123L);
obj2.setExpiredTime(1581492546956L);
obj1.setUploadPolicy(obj2);
req.setGenerateTokenRequest(obj1);
PictureTokenResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<picture_token_response>
    <result>
        <code>200</code>
        <data>
            <token>ZXlKaGNIQkxaWGtpT2lJeElpd2lkWEJzYjJGa1VHOXNhV041SWpwN0ltSnBl</token>
        </data>
        <success>true</success>
        <error_msg>返回成功</error_msg>
    </result>
</picture_token_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部