实际试过之后才知道有多烂
1. 命名风格不统一
同一个接口，一个字段命名为 xxxid ，另一个为 xxx_id 。大概他们自己也觉得蠢，在下一个版本的接口中统一为 xxxid 。
2. 描述不清
一个字段描述是需要随机字符串，没有说明任何字符限制。按照字面理解，我传 random ascii ，结果错！只好老实按照他给的示例值 字母 + 数字 生成，至今不知道是不是做了这个字符限制，懒得再试其它字符。
3. 描述不清 2
接口需要传 json ，有的字段标注非必填。按照我的理解，非必填那就传 null ，结果错！人家的意思是连字段名都不传。不知道他们用的什么开发，是不是很难兼容两种情况，反正我的项目是能轻易兼容的。
总的来说也不是什么大问题，但是总在不应该有的小问题上给你整活儿就很讨厌。
1. 命名风格不统一
同一个接口，一个字段命名为 xxxid ，另一个为 xxx_id 。大概他们自己也觉得蠢，在下一个版本的接口中统一为 xxxid 。
2. 描述不清
一个字段描述是需要随机字符串，没有说明任何字符限制。按照字面理解，我传 random ascii ，结果错！只好老实按照他给的示例值 字母 + 数字 生成，至今不知道是不是做了这个字符限制，懒得再试其它字符。
3. 描述不清 2
接口需要传 json ，有的字段标注非必填。按照我的理解，非必填那就传 null ，结果错！人家的意思是连字段名都不传。不知道他们用的什么开发，是不是很难兼容两种情况，反正我的项目是能轻易兼容的。
总的来说也不是什么大问题，但是总在不应该有的小问题上给你整活儿就很讨厌。
3
Select Language