文档中心 > API类目 > 银泰OPENAPI

alibaba.mos.carnival.mose.sendcoupon (发放优惠券)

发放优惠券

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
coupon_send_request CouponSendRequest 必须 发券参数
  • └ snapshot_id
  • Number
  • 必须
  • 100098456
  • 券快照id
  • └ seq_no
  • String
  • 必须
  • BIZ_MOSE_1
  • 业务key
  • └ num
  • Number
  • 必须
  • 1
  • 发券数量
  • └ player_id
  • String
  • 必须
  • 21dc9270e5d744c7a428511065bd697f
  • 玩家id

响应参数

名称 类型 示例值 描述
total Number 1 结果总数
data CouponDto [] 返回结果
  • └ code
  • String
  • 200001247899
  • 券码
  • └ rights_instance_url
  • String
  • https://
  • 券详情链接
  • └ coupon_wallet_url
  • String
  • https://
  • 卡券包链接
is_success Boolean true 调用结果
biz_err_code String 200 错误码
biz_err_msg String 调用成功 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMosCarnivalMoseSendcouponRequest req = new AlibabaMosCarnivalMoseSendcouponRequest();
AlibabaMosCarnivalMoseSendcouponRequest.CouponSendRequest obj1 = new AlibabaMosCarnivalMoseSendcouponRequest.CouponSendRequest();
obj1.setSnapshotId(100098456L);
obj1.setSeqNo("BIZ_MOSE_1");
obj1.setNum(1L);
obj1.setPlayerId("21dc9270e5d744c7a428511065bd697f");
req.setCouponSendRequest(obj1);
AlibabaMosCarnivalMoseSendcouponResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_mos_carnival_mose_sendcoupon_response>
    <total>1</total>
    <data>
        <coupon_dto>
            <code>200001247899</code>
            <rights_instance_url>https://</rights_instance_url>
            <coupon_wallet_url>https://</coupon_wallet_url>
        </coupon_dto>
    </data>
    <is_success>true</is_success>
    <biz_err_code>200</biz_err_code>
    <biz_err_msg>调用成功</biz_err_msg>
</alibaba_mos_carnival_mose_sendcoupon_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

返回
顶部