文档中心 > API类目 > 飞猪推广平台

alibaba.fliggy.promote.activity.link (推广者取链)

推广者取链

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
promotion_activity_link_request PromotionActivityLinkRequest 必须 参数的实体对象
  • └ activity_id
  • String
  • 必须
  • test_fsa_all
  • 活动Id,运营小二提供
  • └ position_id
  • Number
  • 必须
  • 1287001
  • 推广位id,在推广者后台创建
  • └ qr_code
  • Boolean
  • 可选
  • true
  • 是否需要二维码相关素材,需要(true), 不需要(false),需要请联系小二同学报备场景流量
  • └ media_id
  • Number
  • 必须
  • 359001
  • 媒体id,在推广者后台创建

响应参数

名称 类型 示例值 描述
result_code String SHT_PARAM_ERROR 结果码
model PromotionActivityLinkResponse 返回数据实体类
  • └ link_data
  • String
  • "{\"deliverInfo\":{\"alipay\":{\"longLink\":\"alipays://platformapi/startapp?appId=2018081461095002&page=pages%2Findex%2Findex%3Fsht_track_info%3Dm74cf0nm7n%26outUserId%3Dps_3%26ttid%3Dabctest\",\"miniappMaterial\":{\"appId\":\"2018081461095002\",\"pagePath\":\"pages/index/index?sht_track_info=m74cf0nm7n&outUserId=ps_3&ttid=abctest\"},\"qrCode\":\"https://fli.alicdn.com/upload/sht/P-nzgdExFyb642d4a6bdfe04ae.png\",\"errorMessageArr\":[],\"shortLink\":\"https://pre-a.feizhu.com/3iuL3J\"},\"taobao\":{\"qrCode\":\"https://fli.alicdn.com/upload/sht/k5NwtDJmskb642d4a6bdfe04ae.png\",\"errorMessageArr\":[],\"shortLink\":\"https://pre-a.feizhu.com/3lpgIs\"},\"web\":{\"longLink\":\"https://market.m.taobao.com/app/trip/rx-home/pages/home?sht_track_info=m74cf0nm7n&outUserId=ps_3&ttid=abctest\",\"qrCode\":\"https://fli.alicdn.com/upload/sht/cyPCRqifLjb642d4a6bdfe04ae.png\",\"errorMessageArr\":[],\"shortLink\":\"https://pre-a.feizhu.com/0VB6ih\"},\"wechat\":{\"miniappMaterial\":{\"appId\":\"wx6a96c49f29850eb5\",\"pagePath\":\"pages/main/home?sht_track_info=m74cf0nm7n&outUserId=ps_3&ttid=abctest\"},\"errorMessageArr\":[],\"wxRouterShortLink\":\"https://pre-a.feizhu.com/2LCFCC\",\"wxRouterQrCode\":\"https://fli.alicdn.com/upload/sht/fhiZlMv9fEb642d4a6bdfe04ae.png\",\"wxShortLink\":\"#小程序://飞猪/飞猪订酒店机票火车票汽车票门票/dltu76H7YDAWheh\",\"wxMiniappQrCode\":\"https://img.alicdn.com/imgextra/i1/O1CN01bePjLn1Mx35glhVdR_!!4611686018427381212-0-fliggyimage.jpg\"}}}"
  • 返回数据JSON字符串,物料可能会包括wechat(微信端)、alipay(支付宝端)、taobao(淘宝端)、web(普通H5)类型素材。 wechat(微信端)素材包括:miniappMaterial(小程序素材,用于小程序跳转小程序)、wxShortLink(小程序短链,微信内投放)、wxRouterShortLink(唤端router,多场景投放)、wxRouterQrCode(唤端router二维码,传入qr_code参数后会返回)、wxMiniappQrCode(小程序码,传入qr_code参数后会返回) alipay(支付宝端)素材包括:miniappMaterial(小程序素材,用于小程序跳转小程序)、longLink(alipays开头链接,支付宝内投放)、shortLink(短链)、qrCode(二维码,传入qr_code参数后会返回) taobao(淘宝端)素材包括:shortLink(短链)、qrCode(二维码,传入qr_code参数后会返回) web(普通H5)素材包括:longLink(长链)、shortLink(短链)、qrCode(二维码,传入qr_code参数后会返回) 如需订单回传渠道自身userId,请获取outDeliverInfo 结构中的素材,然后替换其中的 __SHT_OUT_USER_ID__ 为真实外键即可
result_message String 活动不存在 结果返回的描述字符串信息
ext_info Json map 拓展信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaFliggyPromoteActivityLinkRequest req = new AlibabaFliggyPromoteActivityLinkRequest();
AlibabaFliggyPromoteActivityLinkRequest.PromotionActivityLinkRequest obj1 = new AlibabaFliggyPromoteActivityLinkRequest.PromotionActivityLinkRequest();
obj1.setActivityId("test_fsa_all");
obj1.setPositionId(1287001L);
obj1.setQrCode(true);
obj1.setMediaId(359001L);
req.setPromotionActivityLinkRequest(obj1);
AlibabaFliggyPromoteActivityLinkResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_fliggy_promote_activity_link_response>
    <result_code>SHT_PARAM_ERROR</result_code>
    <model>
        <link_data>&quot;{\&quot;deliverInfo\&quot;:{\&quot;alipay\&quot;:{\&quot;longLink\&quot;:\&quot;alipays://platformapi/startapp?appId=2018081461095002&amp;page=pages%2Findex%2Findex%3Fsht_track_info%3Dm74cf0nm7n%26outUserId%3Dps_3%26ttid%3Dabctest\&quot;,\&quot;miniappMaterial\&quot;:{\&quot;appId\&quot;:\&quot;2018081461095002\&quot;,\&quot;pagePath\&quot;:\&quot;pages/index/index?sht_track_info=m74cf0nm7n&amp;outUserId=ps_3&amp;ttid=abctest\&quot;},\&quot;qrCode\&quot;:\&quot;https://fli.alicdn.com/upload/sht/P-nzgdExFyb642d4a6bdfe04ae.png\&quot;,\&quot;errorMessageArr\&quot;:[],\&quot;shortLink\&quot;:\&quot;https://pre-a.feizhu.com/3iuL3J\&quot;},\&quot;taobao\&quot;:{\&quot;qrCode\&quot;:\&quot;https://fli.alicdn.com/upload/sht/k5NwtDJmskb642d4a6bdfe04ae.png\&quot;,\&quot;errorMessageArr\&quot;:[],\&quot;shortLink\&quot;:\&quot;https://pre-a.feizhu.com/3lpgIs\&quot;},\&quot;web\&quot;:{\&quot;longLink\&quot;:\&quot;https://market.m.taobao.com/app/trip/rx-home/pages/home?sht_track_info=m74cf0nm7n&amp;outUserId=ps_3&amp;ttid=abctest\&quot;,\&quot;qrCode\&quot;:\&quot;https://fli.alicdn.com/upload/sht/cyPCRqifLjb642d4a6bdfe04ae.png\&quot;,\&quot;errorMessageArr\&quot;:[],\&quot;shortLink\&quot;:\&quot;https://pre-a.feizhu.com/0VB6ih\&quot;},\&quot;wechat\&quot;:{\&quot;miniappMaterial\&quot;:{\&quot;appId\&quot;:\&quot;wx6a96c49f29850eb5\&quot;,\&quot;pagePath\&quot;:\&quot;pages/main/home?sht_track_info=m74cf0nm7n&amp;outUserId=ps_3&amp;ttid=abctest\&quot;},\&quot;errorMessageArr\&quot;:[],\&quot;wxRouterShortLink\&quot;:\&quot;https://pre-a.feizhu.com/2LCFCC\&quot;,\&quot;wxRouterQrCode\&quot;:\&quot;https://fli.alicdn.com/upload/sht/fhiZlMv9fEb642d4a6bdfe04ae.png\&quot;,\&quot;wxShortLink\&quot;:\&quot;#小程序://飞猪/飞猪订酒店机票火车票汽车票门票/dltu76H7YDAWheh\&quot;,\&quot;wxMiniappQrCode\&quot;:\&quot;https://img.alicdn.com/imgextra/i1/O1CN01bePjLn1Mx35glhVdR_!!4611686018427381212-0-fliggyimage.jpg\&quot;}}}&quot;</link_data>
    </model>
    <result_message>活动不存在</result_message>
    <ext_info>map</ext_info>
</alibaba_fliggy_promote_activity_link_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

返回
顶部