总有些人,希望看开源代码的API像看一个服务的接口那样简单。
这是不现实的。因为两者的性质和使用方式都不相同。
API:通常有很多函数,功能非常全,软件所有可以开放给你的部分都已经开放了。不同的API之间通常要相互配合使用。使用者通常需要了解软件模块的内部架构。
使用过程中,你是参考测试样例写,然后碰到问题去查找API。
一个成型互联网服务的接口:通常不会太多,功能很稳定,功能明确。基本可以独立出来使用。文档也很好写。
使用过程就是,要实现什么功能,大概只看约定的接口就可以解决了。不需要了解内部架构。