## Pixiv 排行榜获取接口 ##

### 接口地址 ###
```
GET https://www.pixiv.net/ranking.php
```

- 是否需要登录: `是`
- 是否为Pixiv标准接口返回格式: `否`
- 是否需要Referer请求头: `否`
### 参数 ###
> 提示: 该接口参数较为复杂，请结合表格查看

- `date`: 排行榜时间，与Mode有关 (格式: yyyy-MM-dd)
- `mode`: 排行榜模式
    - `daily`: 每天
    - `weekly`: 每周
    - `monthly`: 每月
    - `rookie`: 新人
    - `original`: 原创
    - `male`: 男性偏好
    - `female`: 女性偏好
    - `daily_r18`: 每天 - 仅成人内容
    - `weekly_r18`: 每周 - 仅成人内容
    - `male_r18`: 男性偏好 - 仅成人内容
    - `female_r18`: 女性偏好 - 仅成人内容
- `content`: 排行榜内容类型
    - `all`: 全部内容 (实际使用请直接省略`content`参数)
    - `illust`: 插画
    - `ugoira`: 动图
    - `manga`: 漫画
- `p`: 排行榜页数 (如超出范围，则返回错误信息)
- `format`: 格式
    - `json`: 以Json返回数据
    - (留空): 返回完整的排行榜网页

#### 参数关系表 ####
`mode`参数与`content`参数有一些支持关系，并不是所有的`mode`参数都能被所有的`content`参数支持，故附下表。  

参数      |all|illust|ugoira|manga
   :-:    |:-:| :-:  | :-:  | :-:
daily     |`√`|`√`|`√`|`√`
weekly    |`√`|`√`|`√`|`√`
monthly   |`√`|`√`| × |`√`
rookie    |`√`|`√`| × |`√`
original  |`√`| × | × | ×
male      |`√`| × | × | ×
female    |`√`| × | × | ×
daily_r18 |`√`|`√`|`√`|`√`
weekly_r18|`√`|`√`|`√`|`√`
male_r18  |`√`| × | × | ×
female_r18|`√`| × | × | ×

### 返回数据 ###
#### 数据示例 ####
```json
{
    "contents":[
        {
            "title":"【伊アオ】髪結い。",
            "date":"2020年05月31日 14:26",
            "tags":[
                "鬼滅の刃",
                "伊アオ",
                "嘴平伊之助",
                "神崎アオイ",
                "鬼滅の刃1000users入り"
            ],
            "url":"https:\/\/i.pximg.net\/c\/240x480\/img-master\/img\/2020\/05\/31\/14\/26\/41\/81987309_p0_master1200.jpg",
            "illust_type":"0",
            "illust_book_style":"0",
            "illust_page_count":"1",
            "user_name":"シロウ",
            "profile_img":"https:\/\/i.pximg.net\/user-profile\/img\/2020\/05\/01\/02\/18\/18\/18450100_ac34872504959f8cc26f086248066b39_50.png",
            "illust_content_type":{
                "sexual":0,
                "lo":false,
                "grotesque":false,
                "violent":false,
                "homosexual":false,
                "drug":false,
                "thoughts":false,
                "antisocial":false,
                "religion":false,
                "original":false,
                "furry":false,
                "bl":false,
                "yuri":false
            },
            "illust_series":false,
            "illust_id":81987309,
            "width":600,
            "height":2226,
            "user_id":174995,
            "rank":51,
            "yes_rank":83,
            "rating_count":707,
            "view_count":19759,
            "illust_upload_timestamp":1590902801,
            "attr":"",
            "is_bookmarked":false,
            "bookmarkable":true
        }, // ....
    ],
    "mode":"daily",
    "content":"all",
    "page":2,
    "prev":1,
    "next":3,
    "date":"20200601",
    "prev_date":"20200531",
    "next_date":false,
    "rank_total":500
}
```

#### 字段说明 ####
- `contents`: (`Object[]`) 排行榜数组, 最多50行排行榜信息
    - `illust_id`: (`number`) 作品Id
    - `title`: (`string`) 作品标题
    - `attr`: (`string`) 不明?
    - `tags`: (`string[]`) 原始标签数组
    - `url`: (`string`) 预览画质的原始尺寸图下载链接(存在防盗链)
    - `illust_type`: (`string` -> `number`) 作品类型
    - `illust_book_style`: (`string` -> `number`) 不明?
    - `illust_page_count`: (`string` -> `number`) 作品页数
    - `user_name`: (`string`) 画师用户名
    - `user_id`: (`number`) 画师用户Id
    - `profile_img`: (`string`) 画师用户头像
    - `illust_content_type`: (`Object`) 作品内容信息(警告: 文档内容仅作为开发参考, 并不传播相关内容!!!)
        - `sexual`: (`number`) 作品内容分级
            - `0`: 全年龄
            - `1`: 青少年
            - `2`: 成人级
        - `lo`: (`boolean`) 是否为loli作品
        - `grotesque`: (`boolean`) 是否为怪诞作品
        - `violent`: (`boolean`) 作品是否含有暴力/强暴相关元素
        - `homosexual`: (`boolean`) 作品是否含有同性恋相关元素
        - `drug`: (`boolean`) 作品是否含有药物相关元素
        - `thoughts`: (`boolean`) 作品是否含有思维/记忆相关元素(这个属性翻译起来有些问题, 待纠正)?
        - `antisocial`: (`boolean`) 作品是否含有反社会, 令人厌恶的相关元素
        - `religion`: (`boolean`) 作品是否含有宗教, 信仰相关元素
        - `original`: (`boolean`) 作品是否为原创作品
        - `furry`: (`boolean`) 作品是否有兽人相关元素
        - `bl`: (`boolean`) 作品是否有耽美相关元素
        - `yuri`: (`boolean`) 作品是否有百合相关元素
    - `illust_series`: (`boolean`) 是否为系列作品
    - `width`: (`number`) 作品宽度(建议以原图为准)
    - `height`: (`number`) 作品高度(建议以原图为准)
    - `rank`: (`number`) 本期排行榜排名
    - `yes_rank`: (`number`) 上期同排行榜排名
    - `rating_count`: 
    - `view_count`: (`number`) 浏览量
    - `illust_upload_timestamp`: (`number`) 作品上传时间戳(10位)
    - `is_bookmarked`: (`boolean`) 不明?
    - `bookmarkable`: (`boolean`) 不明?
- `mode`: (`string`) 请求的排行榜模式字段
- `content`: (`string`) 请求的内容类型
- `page`: (`number`) 当前排行榜页数
- `prev`: (`string` / `boolean`) 上一页排行榜页数, 如果该请求的页数为首页, 则为`false`
- `next`: (`string` / `boolean`) 下一页排行榜页数, 如果该请求的页数为页尾, 则为`false`
- `date`: (`string`) 排行榜日期(格式：`yyyyMMdd`)
- `prev_date`: (`string` / `boolean`) 如果存在上一期排行榜, 则该属性为上期排行榜日期字符串, 否则为`false`
- `next_date`: (`string` / `boolean`) 如果存在下一期排行榜, 则该属性为下期排行榜日期字符串, 否则为`false`
- `rank_total`: (`number`) 该排行榜的总排行数