文档中心 > API类目 > 零售终端API

tmall.jiazhuang.fulfillment.media.upload (天猫家装涂刷行业履约图片上传接口)

天猫家装涂刷行业履约图片上传接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
img String 必须 /9j/4AAQSkZJRgABAQAAAQABAAD/4gIoSUNDX1BST0ZJTEUAAQEAAAIYAA 传入图片二进制,不能大于5M;base64转化,需要使用encodeUrlSafe
seller_id Number 必须 12345678 卖家id
trade_order_id String 必须 2496456614746916910 图片来源于哪个订单
name String 必须 测试.jpg
  • 最大长度:30
  • 图片名称.最长30个中文字符;文件只支持png、jpg、jpeg
    description String 可选 图片描述
  • 最大长度:200
  • 图片描述. 200字以内;
    draw Boolean 可选 false 是否需要打水印;预留字段

    响应参数

    名称 类型 示例值 描述
    result ResultDO 响应数据
    • data
    • FulfillmentPicUploadRespDTO
    • 媒体文件信息
    • └ trade_order_id
    • Number
    • 2496456614746916910
    • 订单id
    • └ image_url
    • String
    • /jurl.dssx
    • 资源存储url
    • └ err_code
    • String
    • PARAMS_INVALID
    • 错误码
    • └ success
    • Boolean
    • false
    • 是否成功
    • └ err_msg
    • String
    • 参数非法
    • 错误描述

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallJiazhuangFulfillmentMediaUploadRequest req = new TmallJiazhuangFulfillmentMediaUploadRequest();
    req.setImg("/9j/4AAQSkZJRgABAQAAAQABAAD/4gIoSUNDX1BST0ZJTEUAAQEAAAIYAA");
    req.setSellerId(12345678L);
    req.setTradeOrderId("2496456614746916910");
    req.setName("测试.jpg");
    req.setDescription("图片描述");
    req.setDraw(false);
    TmallJiazhuangFulfillmentMediaUploadResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_jiazhuang_fulfillment_media_upload_response>
        <result>
            <data>
                <trade_order_id>2496456614746916910</trade_order_id>
                <image_url>/jurl.dssx</image_url>
            </data>
            <err_code>PARAMS_INVALID</err_code>
            <success>false</success>
            <err_msg>参数非法</err_msg>
        </result>
    </tmall_jiazhuang_fulfillment_media_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

    返回
    顶部