API参数说明

API参数说明其实很简单。当你看到一个API接口的时候，参数说明就像是它的“说明书”，告诉你如何正确使用它。
先说最重要的，参数类型。比如，去年我们跑的那个项目，API参数分为必填和选填两种，必填的参数就像身份证，没有它你进不了系统；选填的参数则像是你的兴趣爱好，不影响基本功能，但能让你体验更丰富。
另外一点，参数值。大概3000量级的数据传输，参数值一定要准确无误，就像填表一样，一个数字错了，整个表格都可能报废。用行话说叫雪崩效应，其实就是前面一个小延迟把后面全拖垮了。
我一开始也以为参数说明只是简单罗列，后来发现不对，它还包含了参数间的逻辑关系，比如先后顺序、依赖关系等。等等，还有个事，参数说明里往往会有一些注意事项，比如“不要重复提交”或“参数长度限制”，这些细节挺关键的，容易忽略。
所以，我的建议是，在使用API之前，一定要仔细阅读参数说明，避免因为一个小错误导致整个项目失败。这个点很多人没注意，我觉得值得试试。