文档中心 > API类目 > 以旧换新-国补

taobao.smp.zfbt.pic.upload.send (国补验机图片上传接口)

国补验机图片上传接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_gb_pic_upload_request TopGbPicUploadRequest 必须 国补图片上传对象
  • └ mail_no
  • String
  • 必须
  • SF123456789
  • 运单号
  • └ report_type
  • Number
  • 必须
  • 10
  • 回传类型
  • pic_info_list
  • TopPicUploadInfoDTO []
  • 可选
  • 图片上传信息列表
  • 图片上传信息列表
  • └ pic_url
  • String
  • 可选
  • https://www.picname.jpg
  • 图片访问url
  • └ pic_type
  • String
  • 可选
  • 301
  • 图片类型编码
  • └ pic_upload_time
  • String
  • 可选
  • 2025-07-28 10:00:01
  • 图片上传时间
  • └ pic_std
  • String
  • 可选
  • A00001
  • 图片标准编码
  • └ tb_sub_trade_id
  • Number
  • 可选
  • 3789192738123212
  • 淘宝子交易单号
  • └ biz_type
  • String
  • 必须
  • GBYJ
  • 业务场景类型
  • └ delivery_brand_code
  • String
  • 可选
  • SF
  • 配送品牌编码
  • └ operate_strategy
  • String
  • 可选
  • APPEND_COVER
  • 操作策略
  • └ remark
  • String
  • 可选
  • 备注
  • 备注
  • └ tb_trade_id
  • Number
  • 可选
  • 3789192738223212
  • 淘宝主交易单号

响应参数

名称 类型 示例值 描述
data PicUploadResultDTO 业务响应参数
  • └ upload_success
  • Boolean
  • true
  • 是否上传成功
  • └ retry
  • Boolean
  • true
  • 是否允许重试
biz_error_desc String 错误信息描述 错误信息描述
suc Boolean true 请求是否成功
biz_error_code String ZFBTPIC.E00003 错误码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SmpZfbtPicUploadSendRequest req = new SmpZfbtPicUploadSendRequest();
SmpZfbtPicUploadSendRequest.TopGbPicUploadRequest obj1 = new SmpZfbtPicUploadSendRequest.TopGbPicUploadRequest();
obj1.setMailNo("SF123456789");
obj1.setReportType(10L);
List<SmpZfbtPicUploadSendRequest.TopPicUploadInfoDTO> list3 = new ArrayList<SmpZfbtPicUploadSendRequest.TopPicUploadInfoDTO>();
SmpZfbtPicUploadSendRequest.TopPicUploadInfoDTO obj4 = new SmpZfbtPicUploadSendRequest.TopPicUploadInfoDTO();
list3.add(obj4);
obj4.setPicUrl("https://www.picname.jpg");
obj4.setPicType("301");
obj4.setPicUploadTime("2025-07-28 10:00:01");
obj4.setPicStd("A00001");
obj1.setPicInfoList(list3);
obj1.setTbSubTradeId(3789192738123212L);
obj1.setBizType("GBYJ");
obj1.setDeliveryBrandCode("SF");
obj1.setOperateStrategy("APPEND_COVER");
obj1.setRemark("备注");
obj1.setTbTradeId(3789192738223212L);
req.setTopGbPicUploadRequest(obj1);
SmpZfbtPicUploadSendResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<smp_zfbt_pic_upload_send_response>
    <data>
        <upload_success>true</upload_success>
        <retry>true</retry>
    </data>
    <biz_error_desc>错误信息描述</biz_error_desc>
    <suc>true</suc>
    <biz_error_code>ZFBTPIC.E00003</biz_error_code>
</smp_zfbt_pic_upload_send_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

返回
顶部