文档中心 > API类目 > 新零售供应链API

alibaba.ascp.channel.file.upload (渠道中心上传文件)

渠道中心上传文件

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_upload_file_request TopUploadFileRequest 必须 上传文件请求
  • └ file_name
  • String
  • 必须
  • 订单1176567889的退款凭证001.jpg
  • 文件名称,只支持以下格式:png、jpg、jpeg、gif、img、xml、xls、xlsx、osp、txt
content byte[] 必须 这里是上传文件的字节流数组 最大不超过5m

响应参数

名称 类型 示例值 描述
trace_id String 2104798f17538817652549000f2333 traceId
retriable Boolean false 是否能重试
biz_success Boolean true 是否能成功
module String https://ascp-channel.oss-cn-hangzhou.aliyuncs.com/c9c497750d834e3ea6eef2cf2e4b7a5c-20250730212246.osp 文件资源路径
biz_error_message String 系统异常 执行失败的错误原因
biz_error_code String system_exception 执行失败的错误码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAscpChannelFileUploadRequest req = new AlibabaAscpChannelFileUploadRequest();
AlibabaAscpChannelFileUploadRequest.TopUploadFileRequest obj1 = new AlibabaAscpChannelFileUploadRequest.TopUploadFileRequest();
obj1.setFileName("订单1176567889的退款凭证001.jpg");
req.setTopUploadFileRequest(obj1);
req.setContent(new FileItem("/tmp/file.txt"));
AlibabaAscpChannelFileUploadResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ascp_channel_file_upload_response>
    <trace_id>2104798f17538817652549000f2333</trace_id>
    <retriable>false</retriable>
    <biz_success>true</biz_success>
    <module>https://ascp-channel.oss-cn-hangzhou.aliyuncs.com/c9c497750d834e3ea6eef2cf2e4b7a5c-20250730212246.osp</module>
    <biz_error_message>系统异常</biz_error_message>
    <biz_error_code>system_exception</biz_error_code>
</alibaba_ascp_channel_file_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

返回
顶部