Home

PixivCS 文档

本文档提供了 PixivCS 的详细使用指南。

文档目录

基础使用

• 使用方式 - 安装、基本使用和示例程序说明
• 登录与认证 - refresh_token 获取和使用方法
• 连接方式 - 三种连接模式的配置和选择

API 参考

• 支持的API端点 - 所有可用的 API 方法和对应端点
• 分页功能 - 分页 API 的使用方法和最佳实践
• 自定义端点访问 - 直接调用未封装的 API 端点

快速开始

1. 安装

   dotnet add package Natsukage.PixivCS

2. 获取 refresh_token

参考 pixivpy 项目的说明： 由于密码登录已不再支持，请使用 refresh_token 进行认证。获取 refresh_token 的方法：

• @ZipFile Pixiv OAuth Flow
• gppt: get-pixivpy-token （推荐，基于 Selenium，易于使用）
• OAuth with Selenium/ChromeDriver

3. 基本使用

   var api = new PixivAppApi();
   var authResult = await api.AuthAsync("your_refresh_token");
   var illustDetail = await api.GetIllustDetailAsync("133368512");

示例程序

项目包含完整的示例程序 PixivCS.Tests，演示了所有核心功能：

• 三种连接方式测试
• 用户认证
• 插画和小说功能
• 搜索功能
• 分页功能

运行示例：

cd PixivCS.Tests
# 编辑 Program.cs 设置你的 refresh_token
dotnet run

常见问题

连接问题

• 网络受限：使用免代理直连模式
• 代理失效：检查代理配置或切换连接模式
• 超时频繁：增加超时时间或启用重试

认证问题

• refresh_token 无效：重新获取新的 token
• 认证过期：库会自动刷新，无需手动处理

API 使用

• 频率限制：合理控制请求频率，处理 PixivRateLimitException
• 分页数据：使用 HasNextPage() 检查，避免无限循环

贡献

欢迎提交 Issue 和 Pull Request 来改进项目。