文档中心 > API类目 > 交易开放

taobao.opentrade.activity.sync (尖货交易活动信息同步)

尖货交易活动信息配置,创建或更新活动信息 在活动时间开始前,所有用户(包括标记可购买的用户),无法购买商品; 在活动时间内,标记可购买的用户可在小程序中跳转下单页,完成购买; 在活动结束后,对限购不再限制,平台开放购买,用户可在小程序内、商品详情、购物车下单购买;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
activity_id String 必须 2132 排队活动ID,排队时如传入,这里需要填写;若未传,这里也可以不传
start_time Date 必须 2020-04-12 15:00:18 活动开始时间
end_time Date 必须 2020-04-18 15:00:18 活动结束时间(全流程结束时间,非排队结束时间)
activity_name String 必须 会员优先购 活动名称
item_id_list Number [] 必须 112123,123123
  • 最大列表长度:20
  • 活动关联的商品列表,使用逗号(,)分割

    响应参数

    名称 类型 示例值 描述
    start_time String 活动开始时间
    item_ids String 活动关联的商品列表,使用逗号(,)分割
    activity_name String 活动名称
    appkey String 创建活动的appkey
    activity_id String 排队活动ID
    gmt_modified String 最近修改时间
    end_time String 活动结束时间

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    OpentradeActivitySyncRequest req = new OpentradeActivitySyncRequest();
    req.setActivityId("2132");
    req.setStartTime(StringUtils.parseDateTime("2020-04-12 15:00:18"));
    req.setEndTime(StringUtils.parseDateTime("2020-04-18 15:00:18"));
    req.setActivityName("会员优先购");
    req.setItemIdList("112123,123123");
    OpentradeActivitySyncResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <opentrade_activity_sync_response>
        <start_time></start_time>
        <item_ids></item_ids>
        <activity_name></activity_name>
        <appkey></appkey>
        <activity_id></activity_id>
        <gmt_modified></gmt_modified>
        <end_time></end_time>
    </opentrade_activity_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

    返回
    顶部