文档中心 > API类目 > 淘宝交易API

taobao.top.secret.appkey.bill.detail (服务商解密账单查询)

服务商解密账单查询,分页返回所有店铺的账单,每个店铺每天仅包含两条数据,当天产生的号租费 和 当天产生的通话费,仅对90天内的账单提供SLA保障。查询账单详情请使用taobao.top.secret.bill.detail接口。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
app_bill_query_request AppBillQueryRequest 可选 卖家账单查询
  • └ page_no
  • Number
  • 必须
  • 1
  • 页号,从1开始
  • └ page_size
  • Number
  • 必须
  • 100
  • 页大小,不得超过1000
  • └ biz_date
  • Date
  • 必须
  • 2022-05-01 00:00:00
  • 账单时间

响应参数

名称 类型 示例值 描述
data BillDetailInfo [] 账单明细
  • └ bill_item
  • Number
  • 1
  • 0-号租费,1-通话费
  • └ bill_duration
  • Number
  • 2
  • 账单持续时间,号租费时单位为天,通话费单位为分钟
  • └ shop_nick
  • String
  • xx旗舰店
  • 店铺名称
  • └ cost
  • String
  • 0.0018
  • 账单计费
  • └ secret_no
  • String
  • 1903213091-1000
  • 已弃用,查询账单详情请使用taobao.top.secret.bill.detail接口。
  • └ start
  • Date
  • 2022-02-01
  • 已弃用,查询账单详情请使用taobao.top.secret.bill.detail接口。
  • └ end
  • Date
  • 2022-02-01
  • 已弃用,查询账单详情请使用taobao.top.secret.bill.detail接口。
  • └ seller_nick
  • String
  • xxx店
  • 商家昵称
total_num Number 1000 账单总个数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TopSecretAppkeyBillDetailRequest req = new TopSecretAppkeyBillDetailRequest();
TopSecretAppkeyBillDetailRequest.AppBillQueryRequest obj1 = new TopSecretAppkeyBillDetailRequest.AppBillQueryRequest();
obj1.setPageNo(1L);
obj1.setPageSize(100L);
obj1.setBizDate(StringUtils.parseDateTime("2022-05-01 00:00:00"));
req.setAppBillQueryRequest(obj1);
TopSecretAppkeyBillDetailResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<top_secret_appkey_bill_detail_response>
    <data>
        <bill_detail_info>
            <bill_item>1</bill_item>
            <bill_duration>2</bill_duration>
            <shop_nick>xx旗舰店</shop_nick>
            <cost>0.0018</cost>
            <secret_no>1903213091-1000</secret_no>
            <start>2022-02-01</start>
            <end>2022-02-01</end>
            <seller_nick>xxx店</seller_nick>
        </bill_detail_info>
    </data>
    <total_num>1000</total_num>
</top_secret_appkey_bill_detail_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

返回
顶部