为了让小伙伴尽快上号，我们开始一起复盘：“这是关于基金购买流程的需求，我在这个地方需要先明确基金的委托类型，我问爷爷找爸爸终于把这个理清楚了，可以分为购买、赎回、定投。结果上线后才发现分类没定义完整。”“这玩意不是接口里写得明明白白吗？”

恒生统一接入平台_周边接口规范(期货,期权_20210812).xls

其次，业务很复杂的时候可以通过接口反推，例如我们在做期货需求时，不清楚期货产品分为哪些，这时我们便可以找到恒生的接口查查它的数据字典，结果就发现答案竟如此清晰：

再次，在写需求文档或和开发沟通发现说不明白时，也可以通过文档来澄清。例如做内容排序时可能有多个时间：创建时间、更新时间、操作时间等等。而你想调用的时间和开发理解的可能会存在差异，这时你便可拉出接口文档告诉他我要的就是CreateTime。

如上图所示，接口通常分为四部分：请求方法、url、请求参数、返回参数：

字段：类的属性

说明：中文释义

类型：属性的类型，只有String、Number、Object、Array四大类

备注：一些解释语，或者写简单的示例

4）返回参数，要分两种情况讨论：

只返回接口调用成功或者失败：code、reason

返回参数：字段、说明、类型、默认值、是否必填

四、一些可供学习的网址

微信开放文档

https://developers.weixin.qq.com/doc/offiaccount/Subscription_Messages/api.html

金融交易统一接入平台

https://ufx.hs.net/

高德地图API

http://lbs.amap.com/api/jsapi-v2/summary