source: ToLove-Ru

基本格式#

https://api.yukino.top/pics/rpic
无附加参数返回图集:anime

参数格式#

在 URL 查询字符串中，参数格式为 <参数名=<1或者0；多个参数之间使用 & 连接。

当指定多个参数时，它们的关系是“和，并且”（即 SQL 中的 AND）。
示例：https://api.yukino.top/pics/rpic?class=scenery&landscape=1&nobjn

查询参数#

参数类型

class
landscape
ua
near_square
big_size, mid_size, small_size
big_res, mid_res, small_res
nobjn

参数用法

class#

• 选择随机图片的图片集。可供选择的图片集见：数据库的表

• 如果不指定，默认为 anime。

landscape#

• 如果不提供该参数，那么默认两种图片都在随机范围之内，也就是sql语句中不会有该条件。

• 1: 横向图片

• 非1: 纵向图片

ua#

• 如果不提供该参数且也未提供 landscape，那么默认两种方向图片都在随机范围之内。

• 如果提供 ua，会忽略掉 landscape 的值，根据浏览器请求的 User-Agent 来判断是否为移动端，如果是移动端，则 ua 会被 landscape=0 替换（返回纵向图片），否则 ua 会被 landscape=1 替换（返回横向图片）。也就是说，自动识别移动端和 PC 端。

• 该参数不需要任何值。

near_square#

• 如果不提供该参数，那么默认两种图片都在随机范围之内，也就是sql语句中不会有该条件。

• 1: 近方形图片，即宽高比在 0.909 ~ 1.1 之间的图片

• 非1: 非近方形图片，即宽高比不在 0.909 ~ 1.1 之间的图片

big_size, mid_size, small_size#

• 如果不提供该参数，那么默认三种图片都在随机范围之内，也就是sql语句中不会有该条件。

• 哪一项为1，就会查询出该尺寸的图片；哪一项为非1，就不会查询出该尺寸的图片。

big_res, mid_res, small_res#

• 如果不提供该参数，那么默认三种图片都在随机范围之内，也就是sql语句中不会有该条件。

• 哪一项为1，就会查询出该分辨率的图片；哪一项为非1，就不会查询出该分辨率的图片。

nobjn#

• 如果不提供该参数，那么默认两种图片都在随机范围之内，也就是sql语句中不会有该条件。否则，将过滤掉 bjn 图片。
• bjn 图片是指衣着有些暴露的图片，包括但不限于泳装等。若对此类图片有所顾虑，可以使用该参数。
• 不能指定只要bjn参数的图片。