文档中心 > API类目 > 天猫校园零售

tmall.campus.retail.marketing.remain.num.get (限购剩余数量查询)

限购剩余数量查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param0 RemainNumRequest 必须 入参
  • └ activity_ids
  • Number []
  • 可选
  • 优惠活动ids
  • └ detail_id_list
  • Number []
  • 可选
  • 优惠详情ids
  • └ tp_id
  • Number
  • 必须
  • 123
  • tp零售商id

响应参数

名称 类型 示例值 描述
result Result 结果
  • └ msg
  • String
  • 消息
  • 接口返回信息
  • └ code
  • String
  • 1
  • 接口返回code
  • data
  • RemainNumResponse
  • 限购结果
  • activities
  • RemainActivityNumQueryResult []
  • 活动限购结果列表
  • └ activity_id
  • Number
  • 123
  • 活动id
  • └ daily_remain_num
  • Number
  • 3
  • 活动日限购剩余数量
  • └ remain_num
  • Number
  • 9
  • 活动总限购剩余数量
  • details
  • RemainDetailNumQueryResult []
  • 详情限购结果列表
  • └ detail_id
  • Number
  • 123
  • 详情id
  • └ daily_remain_num
  • Number
  • 3
  • 详情日限购剩余数量
  • └ remain_num
  • Number
  • 9
  • 详情总限购剩余数量
  • └ success
  • String
  • true
  • 接口请求是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallCampusRetailMarketingRemainNumGetRequest req = new TmallCampusRetailMarketingRemainNumGetRequest();
TmallCampusRetailMarketingRemainNumGetRequest.RemainNumRequest obj1 = new TmallCampusRetailMarketingRemainNumGetRequest.RemainNumRequest();
obj1.setActivityIds(new Long[] {  };
);
obj1.setDetailIdList(new Long[] {  };
);
obj1.setTpId(123L);
req.setParam0(obj1);
TmallCampusRetailMarketingRemainNumGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_campus_retail_marketing_remain_num_get_response>
    <result>
        <msg>消息</msg>
        <code>1</code>
        <data>
            <activities>
                <remain_activity_num_query_result>
                    <activity_id>123</activity_id>
                    <daily_remain_num>3</daily_remain_num>
                    <remain_num>9</remain_num>
                </remain_activity_num_query_result>
            </activities>
            <details>
                <remain_detail_num_query_result>
                    <detail_id>123</detail_id>
                    <daily_remain_num>3</daily_remain_num>
                    <remain_num>9</remain_num>
                </remain_detail_num_query_result>
            </details>
        </data>
        <success>true</success>
    </result>
</tmall_campus_retail_marketing_remain_num_get_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

返回
顶部