文档中心 > API类目 > 猫超卡活动API

tmall.card.activity.lifecycle.notify (更新用户参与活动任务记录)

更新用户参与活动任务记录

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
card_task_notify_req_dto CardTaskNotifyReqDTO 必须 活动更新请求对象
  • └ out_biz_id
  • String
  • 可选
  • request_id_12345abcde
  • 赠送单号,权益达标时必传
  • └ task_type
  • String
  • 可选
  • 01
  • 子任务类型,权益达标时必传
  • └ activity_instance_id
  • String
  • 必须
  • xxxxxxxxxxx
  • 活动实例id,必填,表示用户在活动下的唯一身份标识
  • └ activity_type
  • Number
  • 必须
  • 3
  • 活动类型,必填
  • └ task_token
  • String
  • 可选
  • token_1
  • 子任务标,权益达标时必传,值为权益类型
  • └ status
  • String
  • 必须
  • success
  • 子任务状态码,必填,当表示权益达标时,这个字段传“success”

响应参数

名称 类型 示例值 描述
result CardActTaskNotifyRspDTO 接口返回结果集
  • └ success
  • Boolean
  • true
  • 是否成功
  • response
  • ActivityResponseVO
  • 当前活动的一些基本信息
  • └ task_name
  • String
  • 开卡任务
  • 任务名称
  • └ task_token
  • String
  • taskToken
  • 任务标识
  • └ task_type
  • String
  • 3
  • 任务类型
  • └ activity_code
  • String
  • guangfa
  • 活动码
  • └ activity_instance_id
  • String
  • xxxxxxxxxxx
  • 活动实例 ID
  • └ task_start_time
  • Date
  • 2022-01-21 00:00:00
  • 活动开始时间
  • └ task_end_time
  • Date
  • 2022-01-22 23:59:59
  • 活动结束时间
  • └ task_status_code
  • String
  • success
  • 用户当前子任务的任务状态码
  • └ result_code
  • String
  • 0000
  • 结果码
  • └ result_msg
  • String
  • 成功
  • 结果信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallCardActivityLifecycleNotifyRequest req = new TmallCardActivityLifecycleNotifyRequest();
TmallCardActivityLifecycleNotifyRequest.CardTaskNotifyReqDTO obj1 = new TmallCardActivityLifecycleNotifyRequest.CardTaskNotifyReqDTO();
obj1.setOutBizId("request_id_12345abcde");
obj1.setTaskType("01");
obj1.setActivityInstanceId("xxxxxxxxxxx");
obj1.setActivityType(3L);
obj1.setTaskToken("token_1");
obj1.setStatus("success");
req.setCardTaskNotifyReqDto(obj1);
TmallCardActivityLifecycleNotifyResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_card_activity_lifecycle_notify_response>
    <result>
        <success>true</success>
        <response>
            <task_name>开卡任务</task_name>
            <task_token>taskToken</task_token>
            <task_type>3</task_type>
            <activity_code>guangfa</activity_code>
            <activity_instance_id>xxxxxxxxxxx</activity_instance_id>
            <task_start_time>2022-01-21 00:00:00</task_start_time>
            <task_end_time>2022-01-22 23:59:59</task_end_time>
            <task_status_code>success</task_status_code>
        </response>
        <result_code>0000</result_code>
        <result_msg>成功</result_msg>
    </result>
</tmall_card_activity_lifecycle_notify_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

返回
顶部