From d45cd8aab50cf8eeed436139817268f765621db2 Mon Sep 17 00:00:00 2001
From: LamGC <lam827@lamgc.net>
Date: Thu, 28 May 2020 16:20:16 +0800
Subject: [PATCH] =?UTF-8?q?[Update]=20=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3?=
 =?UTF-8?q?,=20=E5=A2=9E=E5=8A=A0=E6=8E=92=E8=A1=8C=E6=A6=9C=E6=8E=A5?=
 =?UTF-8?q?=E5=8F=A3=E6=96=87=E6=A1=A3,=20=E5=BE=85=E8=A1=A5=E5=85=85?=
 =?UTF-8?q?=E8=BF=94=E5=9B=9E=E6=95=B0=E6=8D=AE;?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 documents/interfaces/Pixiv排行榜接口.md   | 47 ++++++++++++++++++++
 documents/interfaces/Pixiv搜索接口.md     | 52 ++++++++++++++++++++---
 documents/interfaces/Pixiv首页数据接口.md | 10 +++--
 3 files changed, 100 insertions(+), 9 deletions(-)
 create mode 100644 documents/interfaces/Pixiv排行榜接口.md

diff --git a/documents/interfaces/Pixiv排行榜接口.md b/documents/interfaces/Pixiv排行榜接口.md
new file mode 100644
index 0000000..3a5ebaf
--- /dev/null
+++ b/documents/interfaces/Pixiv排行榜接口.md
@@ -0,0 +1,47 @@
+## Pixiv 排行榜获取接口 ##
+
+### 接口地址 ###
+```
+GET https://www.pixiv.net/ranking.php
+```
+
+- 需要登录: `是`
+### 参数 ###
+> 提示: 该接口参数较为复杂，请结合表格查看
+
+- `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`: 排行榜页数 (如超出范围，则返回错误信息)
+
+#### 参数关系表 ####
+`mode`参数与`content`参数有一些支持关系，并不是所有的`mode`参数都能被所有的`content`参数支持，故附下表。  
+
+参数      |all|illust|ugoira|manga
+   :-:    |:-:| :-:  | :-:  | :-:
+daily     |`√`|`√`|`√`|`√`
+weekly    |`√`|`√`|`√`|`√`
+monthly   |`√`|`√`|×|`√`
+rookie    |`√`|`√`|×|`√`
+original  |`√`|×|×|×
+male      |`√`|×|×|×
+female    |`√`|×|×|×
+daily_r18 |`√`|`√`|`√`|`√`
+weekly_r18|`√`|`√`|`√`|`√`
+male_r18  |`√`|×|×|×
+female_r18|`√`|×|×|×
diff --git a/documents/interfaces/Pixiv搜索接口.md b/documents/interfaces/Pixiv搜索接口.md
index d4b23f9..2547272 100644
--- a/documents/interfaces/Pixiv搜索接口.md
+++ b/documents/interfaces/Pixiv搜索接口.md
@@ -1,9 +1,17 @@
 ## Pixiv内容搜索接口 ##
-接口地址: 
+### 说明 ###
+> 注意: 本接口可能会影响Pixiv对账号的行为判断（猜测，不一定会）  
+
+该接口用于在Pixiv搜索内容。
+
+### 接口地址 ###
 ```
-GET https://www.pixiv.net/ajax/search/{Type}/{Content}?{参数...}
+GET https://www.pixiv.net/ajax/search/{Type}/{Content}?{Param...}
 ```
-变量名:
+
+- 需要登录: `是`
+
+### Url参数 ###
 - `Type`: 内容类型
     - illustrations(插画)
     - top(推荐)
@@ -11,6 +19,40 @@ GET https://www.pixiv.net/ajax/search/{Type}/{Content}?{参数...}
     - novels(小说)
 - `Content`: 搜索内容
 
+### 参数 ###
+#### 必填 ####
+- `word`: 与搜索内容一致 (经测试似乎可以省略)
+- `s_mode`: 匹配模式
+    - `s_tag`: 标签，部分一致
+    - `s_tag_full`: 标签，完全一致
+    - `s_tc`: 标签和说明文字
+- `type`: 作品类型
+    - `all`: 插画、漫画和动图
+    - `illust_and_ugoira`: 插画和动图
+    - `illust`: 仅插画
+    - `manga`: 仅漫画
+    - `ugoira`: 仅动图
+- `p`: 指定页数 (当指定页数超出范围后，`body.illust.data`为空数组)
+- `order`: 排序设置
+    - `date`: 按时间从旧到新
+    - `date_d`: 按时间从新到旧
+    - `(Unknown)`: 未知, 猜测是会员功能的热门搜索
+- `mode`: 内容分级设置
+    - `all`: 全部内容
+    - `safe`: 排除成人内容
+    - `r18`: 仅成人内容
+
+#### 选填 ####
+- `wlt`: 作品最低宽度(px)
+- `wgt`: 作品最高宽度(px)
+- `hlt`: 作品最低高度(px)
+- `hgt`: 作品最高高度(px)
+- `ratio`: 作品横宽比过滤 (初步测试表明，该参数无法指定横宽比，可能暂不支持该功能)
+    - `0.5`: 仅横图
+    - `-0.5`: 仅纵图
+    - `0`: 仅正方形图
+- `tool`: 限定作品绘制工具
+- `scd`: 过滤作品发布时间 - 开始时间(yyyy-MM-dd)
+- `scd`: 过滤作品发布时间 - 结束时间(yyyy-MM-dd)
+- `(Unknown)`: 最小收藏数 (该参数为会员限定功能，后续补充)
 
-参数列表:
-- `word`
diff --git a/documents/interfaces/Pixiv首页数据接口.md b/documents/interfaces/Pixiv首页数据接口.md
index 6a0ac6d..befe573 100644
--- a/documents/interfaces/Pixiv首页数据接口.md
+++ b/documents/interfaces/Pixiv首页数据接口.md
@@ -1,14 +1,16 @@
 ## Pixiv首页数据接口 ##
 
-说明：  
-该接口涉及用户账户隐私, 不要尝试对该接口返回数据做不安全云端存储, 或未经用户允许的发送出去.
+### 说明 ###
+> 注意: 该接口涉及用户账户隐私, 不要尝试对该接口返回数据做不安全云端存储, 或未经用户允许的发送出去.  
 
-接口地址：
+该接口用于获取Pixiv推荐给账号的首页作品信息，每次调用都会有不同结果。  
+
+### 接口地址 ###
 ```
 GET https://www.pixiv.net/ajax/top/{type}?mode={mode}&lang={lang}
 ```
 
-参数：
+### 参数 ###
 - `type`: 首页类型
     - `illust`: 插画
     - `manga`: 漫画