taobao.mobile.promotion.benefit.activity.send.share (手淘专用单用户发放接口)

卖家活动中需要通过该API来发放对应的权益。手淘专用、验证分享链路。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
benefit_type Number 必须 123 权益类型 其中ALIPAY_COUPON 对应的type值是1
biz_id String 必须 demo 权益关联的活动ID
detail_id Number 必须 123 活动详情id
feed_id Number 必须 123 广播ID
relation_id Number 必须 123 关联活动id
send_count Number 必须 123 权益发放数量
share_key String 可选 demo 和bizId一起使用,标记分享链路的key。
share_users String 可选 demo 分享链路上的用户及用户是否发奖,u1_true,u2_true
trace_id String 必须 demo 调试线索
unique_id String 必须 demo 事务id

响应参数

名称 类型 示例值 描述
send_result ShareBenefitSendResult 权益发放结果
  • └ error_message
  • String
  • demo
  • 错误信息
  • └ error_code
  • String
  • demo
  • 错误码
  • └ success
  • Boolean
  • false
  • 发放结果是否正常
  • └ result_map
  • Json
  • {\"用户A混淆nick\":{\"isSuccess\":true,\"results\":[{\"failureCount\":0,\"indexId\":0,\"successCount\":1}]}}
  • 发放结果

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
MobilePromotionBenefitActivitySendShareRequest req = new MobilePromotionBenefitActivitySendShareRequest();
req.setBenefitType(123L);
req.setBizId("demo");
req.setDetailId(123L);
req.setFeedId(123L);
req.setRelationId(123L);
req.setSendCount(123L);
req.setShareKey("demo");
req.setShareUsers("demo");
req.setTraceId("demo");
req.setUniqueId("demo");
MobilePromotionBenefitActivitySendShareResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<mobile_promotion_benefit_activity_send_share_response>
    <send_result>
        <error_message>demo</error_message>
        <error_code>demo</error_code>
        <success>false</success>
        <result_map>{\&quot;用户A混淆nick\&quot;:{\&quot;isSuccess\&quot;:true,\&quot;results\&quot;:[{\&quot;failureCount\&quot;:0,\&quot;indexId\&quot;:0,\&quot;successCount\&quot;:1}]}}</result_map>
    </send_result>
</mobile_promotion_benefit_activity_send_share_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>

错误码解释

错误码 错误描述 解决方案
isp.225 权益接收者不存在 检查权益接受者是否存在
isp.295 关联活动详情为空 检查活动入参是否为空
isp.107 mdb一秒防并发 联系开发书年
isp.E1000 权益发放失败 记录traceId参数,提供给开发排查

API工具

如何获得此API

FAQ

返回
顶部