Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jabbany/dhufufu

Dhufufu~ API Database for ACG sites & Related Services 有关各种ACG网站的API啦神马的
https://github.com/jabbany/dhufufu

acg api bangumi

Last synced: 12 days ago
JSON representation

Dhufufu~ API Database for ACG sites & Related Services 有关各种ACG网站的API啦神马的

Awesome Lists containing this project

README 

        
Dhufufu (嘚呼呼~)

========

Dhufufu~ API Database for a lot of services.

Dhufufu 是一个对于几个服务API的拆解与解释，这样方便开发者们使用某些**二次开发文档不足**的站点提供的有限的API.



API Rating (API评级)

--------

APIs are rated on a level according to their ease of use and implementation details.

API将会根据使用的简易程度，和对实现方式的有限的了解（比如通量、频率）进行评级。



Levels have two independant parts, a letter grade from A-F and a number restrictor 0 - 9.

API分级分为两个独立的部分，一个A-F的评分，和一个0-9的修正分。两个部分是完全独立的。



* A : Clear, concise, documented. This type of API is not covered in this project. However there may be

links to the documentation, and tips on possible/example uses or API hacks etc.          

非常明了，使用简单，有充足开发文档。这种 API 接口基本不会在本项目中涉及，除非如果需要重新明确某些API条目的意思

或是定义一些API非正式接口/一些使用范例，以及订正API文档实际使用中可能有的一些错误。

* B : Generally clear and has limited documentation. In this type of API, you may get limited documentation

on what the Interfaces do, their return values/format. However no use cases or documentation on how to set

up connection to the api is given.          

有限的开发文档。这种API接口有有限的开发文档，可能给出了返回的数据类型/格式/API接口位置等等，但是没有介绍使用方法

或是某些返回值的意思。

* C : Not very clear, extremely limited documentation or none at all.          

不清晰，很少或没有开发文档。

* D : No API / Is a WORKING Hack          

没有开放接口。但是有可用的Hack。比如某些站点获取标题，可能有稳定的 HTML 元素包含标题内容于页面上。这种API基本能长期稳定

工作，处理开销较有API的要低，但是也不是特别巨大（可控/线性增长的难度）

* E : No API / Non-Stable Hack          

没有开放接口，不稳定Hack。比如新浪视频地址反查（给出 cid 反查上传者 user_id），这一类接口往往需要借助概率事件

（比如粗暴的进行字符串Google搜索等）。它不保证能稳定的工作，且处理开销巨大（超线性增长的难度/需引发多次网络请求）。

但是总比没有强吧。

* F : No Known API / No Known Hack / Exponential or higher difficulty in Hack          

没有开放接口，没有已知的Hack。这种需求往往没有任何办法满足，它的实现复杂度非常巨大，往往需要动用机器学习或者反复搜索。

接口可能稳定也可能不稳定，但是不管是那个情况，都无法在一个APP里面很好的嵌入。有时这种问题来自官方不给出任何信息反查途径

有时这种复杂度的



0 - 9 Corresponds to the "definitiveness" of the rating. 0 is most definitive 9 is least definitive.

0 - 9 表示API定义的权威度和可靠性，0是最可靠，9是最不可靠