文档中心 > API类目 > 服务平台API

taobao.vas.subsc.search (订购记录导出)

用于ISV查询自己名下的应用及收费项目的订购记录

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
article_code String 必须 ts-1234 应用收费代码,从合作伙伴后台(my.open.taobao.com)-收费管理-收费项目列表 能够获得该应用的收费代码
item_code String 可选 ts-1234-1 收费项目代码,从合作伙伴后台(my.open.taobao.com)-收费管理-收费项目列表 能够获得收费项目代码
start_deadline Date 可选 2000-01-01 00:00:00 到期时间起始值(当start_deadline和end_deadline都不填写时,默认返回最近90天的数据)
end_deadline Date 可选 2000-01-01 00:00:00 到期时间结束值
status Number 可选 1 订购记录状态,1=有效 2=过期 空=全部
autosub Boolean 可选 true 是否自动续费,true=自动续费 false=非自动续费 空=全部
expire_notice Boolean 可选 true 是否到期提醒,true=到期提醒 false=非到期提醒 空=全部
page_size Number 可选 20 一页包含的记录数
page_no Number 可选 1 页码
nick String 可选 hz0799 淘宝会员名

响应参数

名称 类型 示例值 描述
article_subs ArticleSub [] 订购关系对象
  • └ nick
  • String
  • hz0799
  • 淘宝会员名
  • └ article_name
  • String
  • 网店版
  • 应用名称
  • └ article_code
  • String
  • ts-123
  • 应用收费代码,从合作伙伴后台(my.open.taobao.com)-收费管理-收费项目列表 能够获得该应用的收费代码
  • └ item_name
  • String
  • 批量推荐
  • 收费项目名称
  • └ item_code
  • String
  • ts-123-1
  • 收费项目代码,从合作伙伴后台(my.open.taobao.com)-收费管理-收费项目列表 能够获得收费项目代码
  • └ deadline
  • Date
  • 2000-01-01 00:00:00
  • 订购关系到期时间
  • └ status
  • Number
  • 1
  • 状态,1=有效 2=过期
  • └ autosub
  • Boolean
  • true
  • 是否自动续费
  • └ expire_notice
  • Boolean
  • true
  • 是否到期提醒
  • └ start_date
  • Date
  • 2024-01-01 00:00:00
  • 订购关系开始时间
total_item Number 100 总记录数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
VasSubscSearchRequest req = new VasSubscSearchRequest();
req.setArticleCode("ts-1234");
req.setItemCode("ts-1234-1");
req.setStartDeadline(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setEndDeadline(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setStatus(1L);
req.setAutosub(true);
req.setExpireNotice(true);
req.setPageSize(20L);
req.setPageNo(1L);
req.setNick("hz0799");
VasSubscSearchResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<vas_subsc_search_response>
    <article_subs>
        <article_sub>
            <nick>hz0799</nick>
            <article_name>网店版</article_name>
            <article_code>ts-123</article_code>
            <item_name>批量推荐</item_name>
            <item_code>ts-123-1</item_code>
            <deadline>2000-01-01 00:00:00</deadline>
            <status>1</status>
            <autosub>true</autosub>
            <expire_notice>true</expire_notice>
            <start_date>2024-01-01 00:00:00</start_date>
        </article_sub>
    </article_subs>
    <total_item>100</total_item>
</vas_subsc_search_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

返回
顶部