接口全称是应用程序编程接口，是应用程序重要的组成部分。接口可以是一个功能，例如天气查询，短信群发等，接口也可以是一个模块，例如登录验证。接口通过发送请求参数至接口url，经过后台代码处理后，返回所需的结果。
由于接口所包含的内容比较细，在项目中常常需要使用接口文档。研发人员可以根据接口文档进行开发、协作，测试人员可以根据接口文档进行测试，系统也需要参照接口文档进行维护等。
公共参数是每个接口都要携带的参数，描述每个接口的基本信息，用于统计或其他用途，放在header或url参数中。例如：
为了方便给客户端响应，响应数据会包含三个属性，状态码（code）,信息描述（message）,响应数据（data）。客户端根据状态码及信息描述可快速知道接口，如果状态码返回成功，再开始处理数据。
array类型数据。通过list字段，保证data的Object结构。
分页类型数据。返回总条数，用于判断是否可以加载更多。
列表类数据接口，无论是否要求分页，最好支持分页，pageSize=Integer.Max即可。
响应结果定义及常用方法：
统一使用String类型。某些情况，统一使用String可以防止解析失败，减少类型转化操作。
Boolean类型，1是0否。客户端处理时，非1都是false。
status类型字段，从1+开始，区别Boolean的0和1。“0”有两种含义，（1）Boolean类型的false，（2）默认的status
上传/下载，参数增加文件md5，用于完整性校验（传输过程可能丢失数据）。
缩小单位保存数据，如：钱以分为单位、距离以米为单位。
获取token一般会涉及到几个参数，，，，。我们通过以上几个参数来获取调用系统的凭证。
和可以直接通过平台线上申请，也可以线下直接颁发。是全局唯一的，每个将对应一个客户，需要高度保密。
是时间戳，使用系统当前的unix时间戳。时间戳的目的就是为了减轻DOS的GJ。防止请求被拦截后一直尝试请求接口。服务器端设置时间戳阀值，如果请求时间戳和服务器时间超过阀值，则响应失败。
是随机值。随机值主要是为了增加的多变性，也可以保护接口的幂等性，相邻的两次请求不允许重复，如果重复则认为是重复提交，响应失败。
是参数签名，将，，拼接起来进行md5加密（当然使用其他方式进行不可逆加密也没问题）。
，使用参数，，，来获取token，作为系统调用的唯一凭证。可以设置一次有效（这样安全性更高），也可以设置时效性，这里推荐设置时效性。如果一次有效的话这个接口的请求频率可能会很高。推荐加到请求头上，这样可以跟业务参数完全区分开来。
一般调用接口最常用的两种方式就是GET和POST。两者的区别也很明显，GET请求会将参数暴露在浏览器URL中，而且对长度也有限制。为了更高的安全性，所有接口都采用POST方式请求。
ip白名单是指将接口的访问权限对部分ip进行开放。这样就能避免其他ip进行访问*，设置ip白名单比较麻烦的一点就是当你的客户端进行迁移后，就需要重新联系服务提供者添加新的ip白名单。设置ip白名单的方式很多，除了传统的防火墙之外，spring cloud alibaba提供的组件sentinel也支持白名单设置。为了降低api的复杂度，推荐使用防火墙规则进行白名单设置。
限流是为了更好的维护系统稳定性。使用redis进行接口调用次数统计，ip+接口地址作为key，访问次数作为value，每次请求value+1，设置过期时长来限制接口的调用频率。
使用aop全局记录请求日志，快速定位异常请求位置，排查问题原因。
在接口调用过程中，可能会涉及到订单号等敏感数据，这类数据通常需要脱敏处理，最常用的方式就是加密。加密方式使用安全性比较高的非对称加密。非对称加密算法有两个密钥，这两个密钥完全不同但又完全匹配。只有使用匹配的一对公钥和私钥，才能完成对明文的加密和解密过程。
客户端尽量不处理逻辑
客户端不处理金额
客户端参数校验规则可以通过接口返回，同时提供默认规则，接口不通则使用默认规则。
图片文案等，与校验规则类似，通过接口返回，并提供默认。
列表界面
多个boolean可以flag替换
<font color=‘red’>幂等性：不论你请求多少次，资源的状态是一样的。</font>
幂等性是指任意多次请求的执行结果和一次请求的执行结果所产生的影响相同。说的直白一点就是查询操作无论查询多少次都不会影响数据本身，因此查询操作本身就是幂等的。但是新增操作，每执行一次数据库就会发生变化，所以它是非幂等的。
幂等问题的解决有很多思路，这里讲一种比较严谨的。提供一个生成随机数的接口，随机数全局唯一。调用接口的时候带入随机数。第一次调用，业务处理成功后，将随机数作为key，操作结果作为value，存入redis，同时设置过期时长。第二次调用，查询redis，如果key存在，则证明是重复提交，直接返回错误。
1.全局唯一的id
2.先查询一下然后再决定是插入还是更新
3.创建一个去重表（redis）
4.token -> redis
1.多版本控制
2.数据库乐观锁/悲观锁
3.使用状态码 status=0
不能使用数据库本身的自增功能来产生主键值，原因是生产环境为分片部署的。会导致有重复的id值
使用snowflake （雪花）算法（twitter出品）生成唯一的主键值
采用http的状态码进行数据封装，例如200表示请求成功，4xx表示客户端错误，5xx表示服务器内部发生错误。状态码设计参考如下：
状态码枚举类：
响应状态码2xx
响应状态码3xx
响应状态码4xx
响应状态码5xx
版权声明：
本文来源网络，所有图片文章版权属于原作者，如有侵权，联系删除。
本文网址：https://www.mushiming.com/mjsbk/9494.html