# 使用文档 | Pximg API ## 壹 一般用法
以下内容参考Pixiv.cat,有删改.
### 单张作品 适用于一个作品ID中(PID,下同)只有一张图片的作品 - URL: > ` https://i.pximg.org/PID(.jpg|png|gif)` - e.g.: > ` https://i.pximg.org/82775556` ### 多张作品(漫画模式) 适用于一个PID中有多张图片的作品 - URL: > `https://i.pximg.org/PID_p*(.jpg|png|gif)` - e.g.: > `https://i.pximg.org/78286152_p1` // **注意:此处用法与Pixiv.cat不同!** 图片为动态产生,网址结尾副档名部分无实际用途(可以不加),准确档案类型会以Content-Type header 发送. ※ 若您的项目需要存取Pixiv上的图片,且可以直接向Pixiv API抓取原始图片网址,请使用反向代理. ## 贰 i.pximg.net图片反代 可以直接作为Pixiv加速图床使用. 例如: > `https://i.pximg.net/img-original/img/2019/12/14/12/48/38/78286152_p0.jpg` 将“`.net`”替换为“`.org`”: > `https://i.pximg.org/img-original/img/2019/12/14/12/48/38/78286152_p0.jpg` > > ![image](https://i.pximg.org/img-original/img/2019/12/14/12/48/38/78286152_p0.jpg) 因此,对于第三方Pixiv客户端用户,可以在类似(以PixEz为例)“更多”—“偏好设置”—“网络”—“图床 Custom Host”中填入“`i.pximg.org`”,以使用Pximg.org的公益反代服务. 您也可以直接将Pixiv图像嵌入网页中,这将使用Pximg.org的反代服务来实现防盗链处理和CDN加速(由Cloudflare提供),以便更迅速地载入Pixiv图像资源,节约加载时间和服务器带宽. ## 叁 开放 API 接口 开发者可以通过我们开放的API接口二次开发Pixiv反代程序. 当然,对于需求量较大的开发者,我们建议自行部署API(PHP). 以下公开API接口部署在Serv00上. i.pximg.org 实际使用的生产API服务由[野草云HK](https://yecaoyun.com/)提供. 所有接口均适用于GET请求方式. ### 1. PID-ImgURL 接口 通过PID获取图像URL(Origin、Master) `https://open.pximg.org/pid.php` GET请求: |参数|描述|是否必须| |:---:|:---:|:---:| |pid|指定作品PID|必须| |p|页码(从0开始)|可选(默认p=0)| 响应 (JSON): |参数|描述|类型|备注| |:---:|:---:|:---:|:---| |pid|作品的PID|str|| |origin|原图URL|str|| |master|压缩图URL|str|有损压缩,较清晰且加载速度快.| |error|错误信息|str|(仅获取失败时存在)获取图像URL失败. | Demo: > https://open.pximg.org/pid.php?pid=119579799 `{"pid":"119579799","origin":"https:\/\/i.pximg.net\/img-original\/img\/2024\/06\/12\/21\/35\/37\/119579799_p0.png","master":"https:\/\/i.pximg.net\/img-master\/img\/2024\/06\/12\/21\/35\/37\/119579799_p0_master1200.jpg"}` ### 2. 今日日榜-PID 接口 快速获取今日日榜PID数据. > https://open.pximg.org/rank.php GET请求: |参数|描述|是否必须| |:---:|:---:|:---:| |p|第x页日榜数据|可选| |ps|1~x页日榜数据(x≤5)|可选| 响应 (JSON): |参数|描述|类型|备注| |:---:|:---:|:---:|:---| |status_code|状态码|int|参考HTTP状态码| |pid|PID列表|list|| |date|日期|str|| |pid_count|PID总个数|int|每页50个| |message|错误信息|str|仅在获取出错时存在| Demo: > https://open.pximg.org/rank.php?p=1 `{"status_code":200,"pid":["121103000","121098990",……],"date":"2024-08-03","pid_count":50 }` ### 3. 用户作品 接口 通过画师UID获取其所有作品PID > https://open.pximg.org/works.php > > (其实是反代`https://www.pixiv.net/touch/ajax/illust/user_illusts?lang=zh&user_id={$uid}`,5h缓存) GET请求: |参数|描述|是否必须| |:---:|:---:|:---:| |uid|画师uid|必须| 响应 (JSON): |参数|描述|类型|备注| |:---:|:---:|:---:|:---| |error|是否出现错误|bool|无错误为false| |message|错误信息|str|无错误为空| |body:user_illust_ids|作品列表|list|| Demo: > https://open.pximg.org/works.php?uid=1096811 `{"error":false,"message":"","body":{"user_illust_ids":["121240338","121114423",……]}}` ……(暂待补充) ## N/A 捐助 ### Pximg.org 需要你的支持! Pximg.org 作为公益项目,一直致力于为开发者、运维、ACG爱好者等各界朋友提供便捷的图床服务。你的每一次使用,都是对我们最大的鼓励! 为了 Pximg.org 能够持续、稳定地运行下去,我们需要你的帮助!你的每一份捐助,都将被用作服务器和域名的租金,为 Pximg.org 提供更强劲的动力! 即使是一杯咖啡的钱,也能让 Pximg.org 走得更远! USDT TRC20: `TFy2dmqfV3dEzW26ukwFe2YCCRRWwzQSUN`