1. 涉及数目的 JSON 字段,用 int 作为数据类型会更友好,若使用 string 类型,数目为零时,应该使用“0”,不应为””(空串)。
  2. 凡是金额字段的,数据值不要使用 float、double 类型,因为使用 float、double 类型时,计算之后,会有精度丢失,导致计算结果有偏差,对于货币计算是不允许的。正确的做法是使用高精度类型的,如 Java 使用的 BigDecimal。
  3. 图片上传不应该置换 base64 再上传,图片原始数据置换成 base64 会比原文件增加 1/3,对于大图片来说,上传耗费的流量是一个大问题。
  4. 图形验证码字符集建议使用 base58,避免出现字符 “Il0O” 等难以辨认的字符,提升用户体验。
  5. 不要破坏统一的数据结构,毫不动摇的遵循 {"code": 0, "msg": "success", data: {}},会让前端同学省很多事。
  6. 确认好是一个还是两个以上,有两个同类型以上的数据项应当使用数组表示,一个则不允许使用数组存储。错误的表示会让前端人员产生歧义,程序也容易出错。
  7. Object 类型字段默认值 null,不应为 [] 或 “”,int 类型字段默认为 0。