文档中心 > API类目 > 淘金币API

taobao.coin.buyer.details.query (查询买家淘金币明细)

查询买家淘金币明细

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
create_time_from Date 可选 2014-12-01 13:33:28 记录创建时间:开始点
create_time_to Date 可选 2014-12-01 13:33:28 记录创建时间:截止点
out_ids Number [] 可选 123,456
  • 最大列表长度:20
  • 查询外键
    page Number 必须 1 当前页
    page_size Number 必须 10 单页大小
    type Number 必须 0 查询类型,0-全部,1-发放,2-消耗

    响应参数

    名称 类型 示例值 描述
    trace_id String aabb 跟踪ID
    query_result BuyerDetailQueryList 查询结果
    • └ total_count
    • Number
    • 100
    • 总条数
    • └ current_page
    • Number
    • 1
    • 当前页
    • └ total_page
    • Number
    • 5
    • 总页数
    • list
    • OpenCoinDetail []
    • 列表
    • └ id
    • Number
    • 123
    • 主键ID
    • └ gmt_modified
    • Date
    • 2014-12-01 13:33:28
    • 修改时间
    • └ amount
    • Number
    • 123
    • 单笔金币数
    • └ gmt_create
    • Date
    • 2014-12-01 13:33:28
    • 创建时间
    • └ given_nick
    • String
    • hello world
    • 发放者NICK
    • └ out_id
    • Number
    • 123
    • 外键ID
    • └ action_name
    • String
    • hello world
    • 行为名称
    • └ attributes
    • Json
    • 扩展属性
    • └ comments
    • String
    • hello world
    • 备注

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CoinBuyerDetailsQueryRequest req = new CoinBuyerDetailsQueryRequest();
    req.setCreateTimeFrom(StringUtils.parseDateTime("2014-12-01 13:33:28"));
    req.setCreateTimeTo(StringUtils.parseDateTime("2014-12-01 13:33:28"));
    req.setOutIds("123,456");
    req.setPage(1L);
    req.setPageSize(10L);
    req.setType(0L);
    CoinBuyerDetailsQueryResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <coin_buyer_details_query_response>
        <trace_id>aabb</trace_id>
        <query_result>
            <total_count>100</total_count>
            <current_page>1</current_page>
            <total_page>5</total_page>
            <list>
                <open_coin_detail>
                    <id>123</id>
                    <gmt_modified>2014-12-01 13:33:28</gmt_modified>
                    <amount>123</amount>
                    <gmt_create>2014-12-01 13:33:28</gmt_create>
                    <given_nick>hello world</given_nick>
                    <out_id>123</out_id>
                    <action_name>hello world</action_name>
                    <comments>hello world</comments>
                </open_coin_detail>
            </list>
        </query_result>
    </coin_buyer_details_query_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

    返回
    顶部