文档中心 > API类目 > miniapp开放API

taobao.miniapp.distribution.order.precreate (代商家预创建投放计划)

帮助商家,预创建小程序的投放计划,预创建的投放计划,在商家确认以后,则会生效可用。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_request DistributionOrderSaveOpenRequest 必须 投放计划信息
  • └ time_type
  • String
  • 必须
  • 0
  • 时效类型 0:自定义时效; 1:订购期有效;为0时,开始时间和结束时间必传
  • └ url
  • String
  • 必须
  • https://m.duanqu.com?_ariver_appid=XXXX
  • 投放的小程序链接
  • └ app_id
  • Number
  • 必须
  • 300002222222
  • 投放的小程序id
  • └ card_id
  • Number
  • 必须
  • 5
  • 要投放的卡片id
  • └ name
  • String
  • 必须
  • 测试投放计划名字
  • 投放计划名字
  • └ scene_id
  • Number
  • 必须
  • 5
  • 要投放的场景id
  • └ start_time
  • Number
  • 可选
  • 1616381233576
  • 投放计划开始时间
  • └ end_time
  • Number
  • 可选
  • 1616381233576
  • 投放计划结束时间
  • └ card_data
  • String
  • 可选
  • {"a":"3"}
  • 卡片对应的动态表单字段信息

响应参数

名称 类型 示例值 描述
order_success Boolean true 调用是否成功
order_error_code Number 1000 错误码
order_error_info String 参数错误 错误信息
model Number 1 预创建成功的投放计划id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
MiniappDistributionOrderPrecreateRequest req = new MiniappDistributionOrderPrecreateRequest();
MiniappDistributionOrderPrecreateRequest.DistributionOrderSaveOpenRequest obj1 = new MiniappDistributionOrderPrecreateRequest.DistributionOrderSaveOpenRequest();
obj1.setTimeType("0");
obj1.setUrl("https://m.duanqu.com?_ariver_appid=XXXX");
obj1.setAppId(300002222222L);
obj1.setCardId(5L);
obj1.setName("测试投放计划名字");
obj1.setSceneId(5L);
obj1.setStartTime(1616381233576L);
obj1.setEndTime(1616381233576L);
obj1.setCardData("{\"a\":\"3\"}");
req.setOrderRequest(obj1);
MiniappDistributionOrderPrecreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<miniapp_distribution_order_precreate_response>
    <order_success>true</order_success>
    <order_error_code>1000</order_error_code>
    <order_error_info>参数错误</order_error_info>
    <model>1</model>
</miniapp_distribution_order_precreate_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

返回
顶部