淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
instance	CsrTargetedDonateInstanceSyncDTO	必须			需求
instance_info CsrTargetedDonateInstanceInfoDTO 必须需求详情 └ exec_pic String [] 可选 [\"https://cdn.xcx.huochaibox.com/default/BGimage.png\"] 需求封面，图片链接数组 └ receiver_tel String 可选 18888888888 领取人手机号 └ exec_content String 可选为XXX学校送XX物资标题/实施描述 └ address String 可选 xx省/xx市/xx区受益对象地区 └ receiver String 可选张老师领取人姓名 └ beneficiary_num String 可选 2 受益人数 └ exec_count Number 可选 10 需求数量 └ description String 可选这是一批捐赠给学校的教学物资，包含文具、书籍等。需求简介 └ exec_name String 可选文具套装物品名称 └ receiver_address String 可选广东省广州市天河区某街道某号领取人收货地址 └ beneficiary String 可选 XXX学校/三年级一班受益对象 └ receiver_desc String 可选 XXX学校老师领取人身份描述 └ exec_type String 可选生活用品物品类别 └ story String 可选这所学校位于偏远山区，学生缺乏基本的学习用品。希望通过此次捐赠改善他们的学习条件。需求故事 └ area_id String 可选 110101 行政区划代码-六位数字 └ accept_second Number 必须 1 是否接受二手 1是0否 └ unit String 必须个单位例如“个” └ submit_time Number 可选 1740560091108 提交时间时间戳-毫秒 └ instance_out_unique_id String 必须 123 需求实例外部唯一id └ batch_id Number 必须 123 批次id └ project_id Number 必须 123 项目id

名称	类型	示例值	描述
result	CsrResult		返回结果
└ fail_msg String 参数错误错误信息 └ fail_code Number 500 错误码 └ has_success Boolean true 是否成功

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaCsrOpenWorkbenchTargetedInstanceImportRequest req = new AlibabaCsrOpenWorkbenchTargetedInstanceImportRequest();
AlibabaCsrOpenWorkbenchTargetedInstanceImportRequest.CsrTargetedDonateInstanceSyncDTO obj1 = new AlibabaCsrOpenWorkbenchTargetedInstanceImportRequest.CsrTargetedDonateInstanceSyncDTO();
AlibabaCsrOpenWorkbenchTargetedInstanceImportRequest.CsrTargetedDonateInstanceInfoDTO obj2 = new AlibabaCsrOpenWorkbenchTargetedInstanceImportRequest.CsrTargetedDonateInstanceInfoDTO();
obj2.setExecPic("\"https://cdn.xcx.huochaibox.com/default/BGimage.png\"");
obj2.setReceiverTel("18888888888");
obj2.setExecContent("为XXX学校送XX物资");
obj2.setAddress("xx省/xx市/xx区");
obj2.setReceiver("张老师");
obj2.setBeneficiaryNum("2");
obj2.setExecCount(10L);
obj2.setDescription("这是一批捐赠给学校的教学物资，包含文具、书籍等。");
obj2.setExecName("文具套装");
obj2.setReceiverAddress("广东省广州市天河区某街道某号");
obj2.setBeneficiary("XXX学校/三年级一班");
obj2.setReceiverDesc("XXX学校老师");
obj2.setExecType("生活用品");
obj2.setStory("这所学校位于偏远山区，学生缺乏基本的学习用品。希望通过此次捐赠改善他们的学习条件。");
obj2.setAreaId("110101");
obj2.setAcceptSecond(1L);
obj2.setUnit("个");
obj1.setInstanceInfo(obj2);
obj1.setSubmitTime(1740560091108L);
obj1.setInstanceOutUniqueId("123");
obj1.setBatchId(123L);
obj1.setProjectId(123L);
req.setInstance(obj1);
AlibabaCsrOpenWorkbenchTargetedInstanceImportResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

XML示例
JSON示例

<alibaba_csr_open_workbench_targeted_instance_import_response>
    <result>
        <fail_msg>参数错误</fail_msg>
        <fail_code>500</fail_code>
        <has_success>true</has_success>
    </result>
</alibaba_csr_open_workbench_targeted_instance_import_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测试工具错误码查询工具 SDK下载

开放平台

公益三小时公共

alibaba.csr.open.workbench.targeted.instance.import (精准捐外部需求导入)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ