调用别人写好的 api 有什么最佳实践吗？

0.0 http 请求 utf8 编码 json 返回算不算 0.0

你又不是服务提供方你能整出啥最佳实践啊，没有话语权啊兄 dei

几乎所有的程序员写代码都是调用别人写好的 api 。
一般被调用的框架都会写一些示例代码，做的好的还会有“最佳实践”这样的指导文档呢，其目的是指导其他人怎么样写的看起来跟他们几乎一样。

按照自己业务逻辑抽象包一层再到业务层

别问，问就是最佳做法是在自己 service 层包装一下再用

先包装一层比较 XXXAPIClient，所有的异常状态最好用 Exception 重新封装，这样再写自己的逻辑调用这个 API，完全不用关心它是本地还是远程的，做到完全隔离。

1.注意逻辑，不要写死循环。
2.注意异常，默认第三方都是不可靠的。

做好容错，要考虑
1. 业务错误
2. 网络错误
网络错误主要是考虑超时，大量的 timeout 会波及到现有业务。所以需要针对接口有熔断设计，当外部 API 挂掉的时候，要么有备份（额外的替代接口），或者要有服务降级（用 dummy system 直接返回接口无法访问）

降级（ default 实现）
和 try catch Exception

原本英文命名比较冗长或者难记时，封装成中文的再用
大疆的 python api 中文化演示： https://zhuanlan.zhihu.com/p/90607858
草蟒正在做更多的常用模块汉化

写 IO 操作呗。。。。也是别人写好的 API

刚写了一篇文章关于这个的，有需要的话可以看下： https://juejin.im/post/6884945023905988622