文档中心 > API类目 > 客户运营平台API

taobao.opencrm.ext.strategy.generate (外投策略生成)

外投策略生成,生成的结果请注意自行保存,不支持后续查询。效果数据请用接口:taobao.crm.index.effect.data.get

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
ext_deliver_strategy_dto ExtDeliverStrategyDTO 可选 请求参数
  • └ channel
  • String
  • 必须
  • 1
  • 渠道: 1-微信;2-抖音;3-今日头条;4-快手;5-百度;6-其他
  • └ content
  • String
  • 必须
  • {"home":"home"}
  • {"home":"home"}-- 店铺首页 {"item":"1234567"}-- 商品详情页 {"coupon":"1aade1"}-- 优惠券领取页(taobao.opencrm.strategy.activity.list 可获取ID) {"custom":"https://www.taobao.com"}--自定义页面,淘内页面
  • └ node_inst_id
  • String
  • 必须
  • 123456
  • 节点实例id,与taobao.opencrm.ext.strategy.operation使用的nodeinstid不隔离,注意其相互影响。
  • └ name
  • String
  • 必须
  • 外投策略1
  • 策略名称

响应参数

名称 类型 示例值 描述
result ExtDeliverStrategyDTO 返回参数
  • └ strategy_id
  • Number
  • 123
  • 策略Id,生成的策略id,可用于查询效果数据
  • └ target_link
  • String
  • https://shop.m.taobao.com/shop/shopIndex.htm?shop_id=58498856
  • 目标长链接,目标页面的http链接
  • └ dp_link
  • String
  • https://shop.m.taobao.com/shop/shopIndex.htm?shop_id=58498856
  • dp链接,目标页面的deeplink链接,链接有效期30天
  • └ short_link
  • String
  • https://s.tb.cn/y6.qNDU5
  • 淘短链,目标页面的淘短链,淘短链有效期为30天
  • └ x_code_img_url
  • String
  • https://img.alicdn.com/imgextra/*******-xcode.png
  • 二维码图片链接,目标页面的二维码。注意此二维码通过淘短链创建,有效期同样为30天
  • └ tao_pass_word
  • String
  • Mzjwn**********Kb0F6UzLwn5SQIGh0dHBzOi8vbS50Yi5jbi9oLlVCZWxzTWUgIENaMzQ1NyDlpJbmipXnrZbnlaUx
  • 淘口令被base64编码,使用前请先解码。另:有效期30天;并非所有目标链接都会生成淘口令,以创建结果为准。
result_msg String 参数异常 错误信息
result_code String 10001 错误码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
OpencrmExtStrategyGenerateRequest req = new OpencrmExtStrategyGenerateRequest();
OpencrmExtStrategyGenerateRequest.ExtDeliverStrategyDTO obj1 = new OpencrmExtStrategyGenerateRequest.ExtDeliverStrategyDTO();
obj1.setChannel("1");
obj1.setContent("{\"home\":\"home\"}");
obj1.setNodeInstId("123456");
obj1.setName("外投策略1");
req.setExtDeliverStrategyDto(obj1);
OpencrmExtStrategyGenerateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<opencrm_ext_strategy_generate_response>
    <result>
        <strategy_id>123</strategy_id>
        <target_link>https://shop.m.taobao.com/shop/shopIndex.htm?shop_id=58498856</target_link>
        <dp_link>https://shop.m.taobao.com/shop/shopIndex.htm?shop_id=58498856</dp_link>
        <short_link>https://s.tb.cn/y6.qNDU5</short_link>
        <x_code_img_url>https://img.alicdn.com/imgextra/*******-xcode.png</x_code_img_url>
        <tao_pass_word>Mzjwn**********Kb0F6UzLwn5SQIGh0dHBzOi8vbS50Yi5jbi9oLlVCZWxzTWUgIENaMzQ1NyDlpJbmipXnrZbnlaUx</tao_pass_word>
    </result>
    <result_msg>参数异常</result_msg>
    <result_code>10001</result_code>
</opencrm_ext_strategy_generate_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

返回
顶部