接口规范、容错处理规则、aph备份数据规则
前话:前后解耦,前端开发环节使用APH,后台开发环节postman(可考虑为后台也做一个aph后台版)
1、api标准:标识符(ret:1为正常数据,0为接口报错),数据体(data:api的数据容器,正常接口时的所有数据必须放置在这里),错误体(error:当接口报错时,容纳错误信息)
2、api接口容错处理,每个接口要有三个数据版本:(这要与后台约定规范,空置数据统一null处理,数字、字符串类型的合理利用)。
前端容错规则:非null则为正常数据,正常处理,而null一律走容错处理(这样区分开数字类型0,字符串类型‘’)
(1)每个api接口的数据要有至少三个版本:1、健康数据(接口中所有字段数据齐全、类型合规);2、畸形数据(局部数据病态,与后台约定病态数据统一以null标识,见null做容错处理);3、报错接口数据,一般ret为0的接口