README.md

HibiAPI

一个实现了多种常用站点的易用化 API 的程序.

A program that implements easy-to-use APIs for a variety of commonly used sites.

---

前言

• HibiAPI提供多种网站公开内容的 API 集合, 它们包括:

  • Pixiv 的图片和小说相关信息获取和搜索
  • Bilibili 的视频/番剧等信息获取和搜索
  • 网易云音乐的音乐/MV 等信息获取和搜索
  • 百度贴吧的帖子内容的获取
  • 爱壁纸的横版和竖版壁纸获取
  • 哔咔漫画的漫画信息获取和搜索
  • …

• 该项目的前身是 Imjad API¹

  • 由于它的使用人数过多, 致使调用超出限制, 所以本人希望提供一个开源替代来供社区进行自由地部署和使用, 从而减轻一部分该 API 的使用压力

优势

开源

• 本项目以Apache-2.0许可开源, 请看开源许可一节

高效

• 使用 Python 的异步机制, 由FastAPI驱动, 带来高效的使用体验 虽然性能瓶颈压根不在这

稳定

• 在代码中广泛使用了 Python 的类型提示支持, 使代码可读性更高且更加易于维护和调试

• 在开发初期起就一直使用多种现代 Python 开发工具辅助开发, 包括:

  • 使用 PyLance 进行静态类型推断
  • 使用 Flake8 对代码格式进行检查
  • 使用 Black 格式化代码以提升代码可读性

• 不直接使用第三方开发的 API 调用库, 而是全部用更加适合 Web 应用的逻辑重写第三方 API 请求, 更加可控 疯狂造轮子

已实现 API²

• Pixiv
• 网易云音乐
• 一言 (其代替方案https://hitokoto.cn提供的方案已足够好, 暂不考虑支持)
• Bilibili
• 二维码
• 企鹅 FM (似乎用的人不是很多)
• 百度贴吧
• 爱壁纸
• 哔咔漫画

部署指南

• 手动部署指南: 点击此处查看

应用实例

我有更多的应用实例? 立即 PR!

• journey-ad/pixiv-viewer

  • 又一个 Pixiv 阅览工具

• 公开搭建实例

  站点名称	网址	状态
  官方 Demo3	https://api.obfs.dev
  MyCard	https://hibi.moecube.com

特别鸣谢

@journey-ad 大佬的 Imjad API, 它是本项目的起源

参考项目

正是因为有了你们, 这个项目才得以存在

• Pixiv: Mikubill/pixivpy-async upbit/pixivpy

• Bilibili: SocialSisterYi/bilibili-API-collect soimort/you-get

• 网易云音乐: metowolf/NeteaseCloudMusicApi greats3an/pyncm Binaryify/NeteaseCloudMusicApi

• 百度贴吧: libsgh/tieba-api

• 哔咔漫画：niuhuan/pica-rust abbeyokgo/PicaComic-Api

贡献者们

感谢这些为这个项目作出贡献的各位大佬:

Kyomotoi 📖 ⚠️	城倉奏 💡	SkipM4 📖	Nook 💻	Jocky Chiang 💻	midori 📖	Pretty9 💻
Jad 🐛 🤔	Yumine Sakura 💻	yeyang 💻

本段符合 all-contributors 规范

开源许可

Copyright 2020-2021 Mix Technology

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Footnotes

1. 什么是 Imjad API ↩

2. 请查看 #1 ↩

3. 为了减轻服务器负担, Demo 服务器已开启了 Cloudflare 全站缓存, 如果有实时获取更新的需求, 请自行搭建或使用其他部署实例 ↩