taobao.trade.voucher.upload (淘宝交易凭证上传)

定制化交易流程中,涉及到 买家自定义 图片、声音、视频 等多富媒体文件,且该商品或服务的附属sku,通过此接口上传作为交易凭证。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
file_name String 必须 example
  • 最大长度:50
  • 上传文件的名称
    file_data byte[] 必须 我是被上传的文件内容 文件
    seller_nick String 可选 奥利奥官方旗舰店 该笔订单的卖家Nick
    buyer_nick String 可选 101NufynDYcbjf2cFQDd62j8M/mjtyz6RoxQ2OL1c0e/Bc= 该笔订单的买家Nick(混淆nick)

    响应参数

    名称 类型 示例值 描述
    file File 上传到多媒体平台的文件
    • └ file_path
    • String
    • http://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg
    • 返回的是绝对路径如:http://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg
    • └ status
    • String
    • pass
    • 图片状态,unfroze代表没有被冻结,froze代表被冻结,pass代表排查通过
    • └ deleted
    • String
    • deleted
    • 文件是否删除
    • └ size
    • Number
    • 100
    • 文件的大小
    • └ picture_pix
    • String
    • 100x100
    • 图片像素,如果非图片,该值为空
    • └ gmt_create
    • Date
    • 2000-01-01 00:00:00
    • 创建时间

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TradeVoucherUploadRequest req = new TradeVoucherUploadRequest();
    req.setFileName("example");
    req.setFileData(new FileItem("/tmp/file.txt"));
    req.setSellerNick("奥利奥官方旗舰店");
    req.setBuyerNick("101NufynDYcbjf2cFQDd62j8M/mjtyz6RoxQ2OL1c0e/Bc=");
    TradeVoucherUploadResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <trade_voucher_upload_response>
        <file>
            <file_path>http://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg</file_path>
            <status>pass</status>
            <deleted>deleted</deleted>
            <size>100</size>
            <picture_pix>100x100</picture_pix>
            <gmt_create>2000-01-01 00:00:00</gmt_create>
        </file>
    </trade_voucher_upload_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

    返回
    顶部