注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 公益三小时公共

alibaba.charity.useraction.sync (用户公益行为同步)

外部公益活动,用户公益行为同步

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
channel_user_action_dto ChannelUserActionDto 必须 用户公益行为
  • └ activity_id
  • Number
  • 必须
  • 12345
  • 活动ID
  • └ event_id
  • String
  • 必须
  • UNI_9901
  • 唯一的动作ID,渠道范围内唯一,幂等控制
  • └ tb_user_id
  • Number
  • 可选
  • 12345
  • 淘宝ID
  • └ timestamp_long
  • Number
  • 可选
  • 12345
  • 做公益当时的时间戳
  • └ charity_type_sub_code
  • String
  • 可选
  • SUB_CODE
  • 公益类型子代码
  • └ fore_reg_activity
  • Boolean
  • 可选
  • false
  • 是否强制报名活动,默认false
  • └ features_map
  • String
  • 可选
  • {}
  • 扩展属性
  • └ feeling
  • String
  • 可选
  • 公益感言
  • 公益感言
  • └ charity_timestamp
  • Date
  • 必须
  • 2019-08-08 12:00:00
  • 做公益当时的时间
  • └ ori_content
  • String
  • 可选
  • {}
  • 原生公益行为内容,JSON
  • └ third_user_key
  • String
  • 可选
  • 123
  • 三方用户标识
  • └ version
  • String
  • 可选
  • 2
  • 版本

响应参数

名称 类型 示例值 描述
result ThreehoursResult 结果 结果
  • └ msg
  • String
  • 成功
  • 消息
  • └ code
  • Number
  • 200
  • 错误码
  • data
  • UserActionSyncResult
  • 结果
  • 结果
  • └ event_id
  • String
  • aaa
  • 唯一的事件ID
  • └ charity_hours
  • String
  • 0.1
  • 本次同步获得的公益时
  • └ success
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaCharityUseractionSyncRequest req = new AlibabaCharityUseractionSyncRequest();
AlibabaCharityUseractionSyncRequest.ChannelUserActionDto obj1 = new AlibabaCharityUseractionSyncRequest.ChannelUserActionDto();
obj1.setActivityId(12345L);
obj1.setEventId("UNI_9901");
obj1.setTbUserId(12345L);
obj1.setTimestampLong(12345L);
obj1.setCharityTypeSubCode("SUB_CODE");
obj1.setForeRegActivity(false);
obj1.setFeaturesMap("{}");
obj1.setFeeling("公益感言");
obj1.setCharityTimestamp(StringUtils.parseDateTime("2019-08-08 12:00:00"));
obj1.setOriContent("{}");
obj1.setThirdUserKey("123");
obj1.setVersion("2");
req.setChannelUserActionDto(obj1);
AlibabaCharityUseractionSyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_charity_useraction_sync_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <event_id>aaa</event_id>
            <charity_hours>0.1</charity_hours>
        </data>
        <success>true</success>
    </result>
</alibaba_charity_useraction_sync_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

返回
顶部