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

alibaba.fliggy.cps.coupon.offer (飞猪CPS通用卡券发放接口)

飞猪CPS通用卡券发放接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
buy_user_request BuyUserRequest 必须 请求入参
  • └ promote_user_id
  • Number
  • 必须
  • 12345678
  • 推广者淘宝用户ID
  • └ mobile
  • String
  • 必须
  • 18012345678
  • 手机号码
  • └ plan_id
  • Number
  • 必须
  • 12345678
  • 推广者计划ID,由对接小二提供
  • └ second_promote_user_id
  • String
  • 可选
  • 12345678
  • 自定义字符串,小于50个字符串,可用来区分同渠道的不同资源位
  • └ channel_code
  • String
  • 必须
  • feizhu
  • 渠道标识符,如自己渠道的拼音,由对接小二提供

响应参数

名称 类型 示例值 描述
result Result 返回响应
  • └ success
  • Boolean
  • true
  • true:成功 false:失败
  • model
  • CollectCouponResponse
  • 领取券详情
  • └ coupons
  • String
  • [ { "resourceId": "5060908805434", "endDate": 1675958399000, "threshold": "满4减3", "plusDesc": null, "templateId": "8770590372", "title": "3元汽车票优惠券", "type": 13, "gmtCreateTime": 1675331558000, "peerUmpResourceId": null, "status": 0 } ]
  • 券信息详情
  • └ first_apply
  • Boolean
  • false
  • true:第一次领取 false:非第一次领取(即重复领取)
  • └ msg_info
  • String
  • success
  • 返回码中文解释
  • └ msg_code
  • String
  • 操作成功
  • 返回码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaFliggyCpsCouponOfferRequest req = new AlibabaFliggyCpsCouponOfferRequest();
AlibabaFliggyCpsCouponOfferRequest.BuyUserRequest obj1 = new AlibabaFliggyCpsCouponOfferRequest.BuyUserRequest();
obj1.setPromoteUserId(12345678L);
obj1.setMobile("18012345678");
obj1.setPlanId(12345678L);
obj1.setSecondPromoteUserId("12345678");
obj1.setChannelCode("feizhu");
req.setBuyUserRequest(obj1);
AlibabaFliggyCpsCouponOfferResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_fliggy_cps_coupon_offer_response>
    <result>
        <success>true</success>
        <model>
            <coupons>[     {         &quot;resourceId&quot;: &quot;5060908805434&quot;,         &quot;endDate&quot;: 1675958399000,         &quot;threshold&quot;: &quot;满4减3&quot;,         &quot;plusDesc&quot;: null,         &quot;templateId&quot;: &quot;8770590372&quot;,         &quot;title&quot;: &quot;3元汽车票优惠券&quot;,         &quot;type&quot;: 13,         &quot;gmtCreateTime&quot;: 1675331558000,         &quot;peerUmpResourceId&quot;: null,         &quot;status&quot;: 0     } ]</coupons>
            <first_apply>false</first_apply>
        </model>
        <msg_info>success</msg_info>
        <msg_code>操作成功</msg_code>
    </result>
</alibaba_fliggy_cps_coupon_offer_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

返回
顶部