从微信支付宝支付接口设计谈 API 接口产品的设计经验和最佳实践

这两年做了一款支付产品，重新定义了产品的对外开放平台 API 的形态，优化了产品体验，重构了支付平台，把接口设计的各种经验分享出来，免得大家设计不合理的接口，影响开发者使用，或者被开发者吐槽不专业、不好用、太重等。

具体问题包括但不仅限于：

1. 命令模式真的很好吗？
2. 为什么有的文档看起来就像吃烤鱼一样爽，而有的文档看起来很辛苦？
3. 驼峰式命名？下划线分割命名？还是都小写字母？有什么讲究吗？
4. 我们需要万恶的 ext1，ext2 这类字段吗？
5. 对账 API 怎么设计会更方便？
6. 到底要签名，还是加密，对称还是非对称呢？
7. 范围查询真的是支付平台应该提供的功能吗？
8. 回调模式取密钥真的那么好用吗？
9. 好的 API 是会说话的，而不是腼腆不语的。
10. 文档的用词是不是都用英文，前后一致呢？
11. 开放平台下一定要用 APPID 吗？
12. 撤销、关闭和退款都是什么鬼？
13. 同步还是异步的抉择？

阅读全文: http://gitbook.cn/gitchat/activity/5a78d35352f425170ff4ce72

您还可以下载 CSDN 旗下精品原创内容社区 GitChat App ，阅读更多 GitChat 专享技术内容哦。