API接口设计需要注意的那些事儿

随著其间端分立，api USB显得愈来愈关键，做为其间端通讯的USB，api 显得十分关键，所以它的结构设计也是十分难以掌控。不但要考量可靠性，更要考量可移植性，以及未来的升级换代之类。

怎样就可以结构设计出更快的 api USB，我认为几点须要特别注意。

USB连续性

这儿说的连续性指的是代码规范化要标准化，不能各USB采用不那样的代码艺术风格。对回到文件格式的处置也是那样，要标准化回到文件格式，回到码也要标准化，对403，404的处置要完全一致。

许可证书

绝大部分USB都是须要许可证书的，因而他们须要对USB的许可证书展开推论，这样能过滤器掉绝大部分的违法出访。

他们如果结构设计两个监视控制系统或是两个USB来动态监视他们的服务项目，如果USB出现了问题，他们如果能第三天数辨认出，反之亦然，对每一USB的出访允诺他们都要有笔记历史记录的储存。

不论是小流程，却是app，却是中文网站，他们都是须要版升级换代的，而提早结构设计好版，能防止即使升级换代引致旧的服务项目难以恒定组织工作，他们要确保在升级换代的这时候，旧有版的服务项目都能恒定运行。

对USB模块的特征值，模块的类别，他们都要展开推论处置，对许多违法表头，他们要及时辨认出并处置，总之，用户传送的信息，他们总要保持怀疑态度去处置它。

虽然restful艺术风格被许多人质疑，但是目前来看，它却是最好的USB结构设计艺术风格，通过采用restful艺术风格，能让USB语义更加明确，规范化，优雅省去了绝大部分无意义的沟通，通过采用不同的http状态码，能十分清楚地帮助用户理解USB的回到情况。

无论他们的USB结构设计得多么规范化，多么易懂，他们都须要提供一份完整的api文档，同时他们还须要提供许多允诺范例，这样用户在采用的这时候才会更加清楚，也能防止许多错误的允诺。

对错误信息回到的这时候尽量要明确，是流程问题，却是查找问题，却是模块问题，或是其他原因，给出明确具体的错误原因，十分方便他们对问题的处置。

对资源的允诺都采用分页回到，一方面减少了资源的回到，一方面减少了服务项目器的开销。

你永远不知道你的用户会怎样采用你的USB，可能它会即使错误地回到结果而不停地重试USB，他们要能对频繁允诺展开限制。