注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 公益三小时公共

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

精准捐外部需求导入

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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
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工具

如何获得此API

FAQ

返回
顶部