# 获取账单详情列表

### 接口URL

```
http://api.polyv.net/live/v3/finance/bill/list-detail
```

### 接口说明

```
分页获取帐号日账单列表
接口支持https
```

### 请求方式

```
GET
```

### 请求参数

| 参数名       | 必选    | 类型及范围  | 说明                                                                                                                                                                                                        |
| --------- | ----- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| sign      | true  | String | 签名，为32位大写的MD5值,`生成签名的appSecret密钥作为通信数据安全的关键信息，严禁保存在客户端直接使用，所有API都必须通过客户自己服务器中转调用POLYV服务器获取响应数据`【详见[签名生成规则](https://git.polyv.net/help-center/document-center/-/blob/master/live/api/buildSign/README.md)】 |
| appId     | true  | string | 开发者账号下的appId                                                                                                                                                                                              |
| timestamp | true  | string | 13位当前时间的时间戳                                                                                                                                                                                               |
| type      | false | string | 账单类型，live：云直播，mic：连麦 , 默认：live                                                                                                                                                                            |
| page      | false | int    | 第几页                                                                                                                                                                                                       |
| pageSize  | false | int    | 每页大小                                                                                                                                                                                                      |
| startDay  | false | string | 开始时间，格式：YYYY-MM-DD                                                                                                                                                                                        |
| endDay    | false | string | 结束时间，格式：YYYY-MM-DD                                                                                                                                                                                        |
| channelId | false | int    | 频道号                                                                                                                                                                                                       |

### 返回正确结果JSON示例

```json
{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "pageSize": 2,
        "pageNumber": 1,
        "totalItems": 123,
        "contents": [
            {
                "id": "xx",
                "total": 1,
                "channelId": 431596,
                "joinTime": "09:46:35",
                "leaveTime": "09:46:38",
                "resumeDate": "2020-03-25",
                "uid": "1585100782973",
                "productType": "云直播",
                "desc": "回放",
                "nick": "肇庆观众/87907"
            },
            {
                "id": "xxx",
                "total": 2,
                "channelId": 902256,
                "joinTime": "15:09:06",
                "leaveTime": "15:10:39",
                "resumeDate": "2020-03-24",
                "uid": "60806543b2",
                "productType": "云直播",
                "desc": "直播",
                "nick": "huahua li"
            }
        ],
        "startRow": 1,
        "firstPage": true,
        "lastPage": false,
        "nextPageNumber": 2,
        "prePageNumber": 1,
        "limit": 2,
        "totalPages": 62,
        "endRow": 2,
        "offset": 0
    }
}
```

### 响应失败JSON示例：

未输入appId

```json
{
    "code": 400,
    "status": "error",
    "message": "appId is required.",
    "data": ""
}
```

appId不正确

```json
{
    "code": 400,
    "status": "error",
    "message": "application not found.",
    "data": ""
}
```

时间戳错误

```json
{
    "code": 400,
    "status": "error",
    "message": "invalid timestamp.",
    "data": ""
}
```

签名错误

```json
{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}
```

非法账单类型

```json
{
    "code": 400,
    "status": "error",
    "message": "invalid bill type",
    "data": ""
}
```

### 字段说明

| 字段      | 类型及范围     | 说明                   |
| ------- | --------- | -------------------- |
| code    | int       | 接口请求状态码，200表示成功      |
| status  | string    | 接口请求状态，"success"表示成功 |
| message | string    | 请求失败时返回的错误信息         |
| data    | Paginator | 账单的分页结果              |

#### 数据对象字段说明

**Paginator**

说明：抽奖记录的分页结果

| 字段             | 类型及范围   | 说明                    |
| -------------- | ------- | --------------------- |
| pageNumber     | int     | 当前的页数                 |
| totalItems     | int     | 总记录数                  |
| firstPage      | boolean | 是否为第一页，值为：true/false  |
| lastPage       | boolean | 是否为最后一页，值为：true/false |
| nextPageNumber | int     | 下一页编号                 |
| prePageNumber  | int     | 上一页编号                 |
| totalPages     | int     | 总页数                   |
| startRow       | int     | 当前页第一条记录在总记录中的位置      |
| endRow         | int     | 当前页最后一个记录在总记录中的位置     |
| limit          | int     | 当前页记录个数               |
| contents       | List    | 账单列表                  |

**BillDetailModel**

说明：抽奖记录

| 字段          | 类型及范围  | 说明                         |
| ----------- | ------ | -------------------------- |
| id          | string | 字符串，连麦和云直播有不同，连麦自曾，云直播可能为空 |
| total       | int    | 总消费时长,单位分钟                 |
| channelId   | string | 频道号                        |
| joinTime    | int    | 加入时间                       |
| leaveTime   | string | 离开时间                       |
| resumeDate  | string | 消费时间                       |
| productType | string | 产品项                        |
| uid         | string | 使用者Id                      |
| desc        | string | 明细                         |
| nick        | long   | 昵称                         |

### PHP请求示例

```php
<?php

//引用config.php
include 'config.php';

$type = "mic";
$params = array(
        'appId'=>$appId,
        'type'=>$type,
        'timestamp'=>$timestamp
    );

//生成sign
$sign = getSign($params); //详细查看config.php文件
$params['sign'] = $sign;
$url="http://api.polyv.net/live/v3/finance/bill/list-detail?".http_build_query($params);
echo "<script>window.location.href='$url'</script>";
?>

```